Функция ChooseFont


Функция ChooseFont создает стандартное диалоговое окно Шрифт (Font), которое дает возможность пользователю выбрать атрибуты для логического шрифта. Эти атрибуты включают в себя название шрифта, стиль (полужирный, курсивный или обычный), размер в пунктах, эффекты (подчеркивание, зачеркивание и цвет текста) и написание (или набор символов).

Синтаксис

BOOL ChooseFont(
    LPCHOOSEFONT lpcf
);

Параметры

lpcf

[in, out] Указатель на структуру CHOOSEFONT, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда ChooseFont возвращает значение, эта структура содержит информацию о выборе шрифта пользователем.

Возвращаемые значения

Если пользователь щелкнул по кнопке диалогового окна ОК, возвращается значение не нуль. Члены структуры CHOOSEFONT показывают выбор пользователя.

Если пользователь прерывает работу или закрывает диалоговое окно Шрифт (Font) или происходит ошибка, возвращается значение нуль. Чтобы получить дополнительную информацию об ошибке, вызовите функцию CommDlgExtendedError, которая может возвратить одно из ниже перечисленных значений:

CDERR_DIALOGFAILURE
CDERR_FINDRESFAILURE
CDERR_NOHINSTANCE
CDERR_INITIALIZATION
CDERR_NOHOOK
CDERR_LOCKRESFAILURE
CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE
CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE
CFERR_MAXLESSTHANMIN
CDERR_MEMALLOCFAILURE
CFERR_NOFONTS
CDERR_MEMLOCKFAILURE

Замечания

Вы можете предусмотреть фильтр - процедуру CFHookProc  для диалогового окна Шрифт (Font). Фильтр - процедура может обрабатывать сообщения, передаваемые в диалоговое окно. Чтобы разрешить работу фильтр - процедуры, установите флажок CF_ENABLEHOOK в члене Flags структуры CHOOSEFONT и определите адрес фильтр - процедуры в члене lpfnHook.

Фильтр - процедура может отправить в диалоговое окно сообщения WM_CHOOSEFONT_GETLOGFONT, WM_CHOOSEFONT_SETFLAGS и WM_CHOOSEFONT_SETLOGFONT, чтобы получить и установить текущие значения и флаги диалогового окна.

Windows 95/98/Me: ChooseFontW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Пример

Пример смотри в статье  Выбор шрифта.

Смотри также 

Обзор Библиотека стандартных диалоговых оконФункции, используемые библиотекой стандартных диалоговых окон, CFHookProc, CHOOSEFONT, CommDlgExtendedError, LOGFONT, WM_CHOOSEFONT_GETLOGFONT, WM_CHOOSEFONT_SETFLAGS, WM_CHOOSEFONT_SETLOGFONT

Размещение и совместимость ChooseFont

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Comdlg32.lib

Заголовочный файл

 

- объявлено в

Commdlg.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz