Win32 API. Справочник по стандартному диалоговому окну
Страница 3. Функция ChooseFont


Функция ChooseFont

(ВыборШрифта)

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

Синтаксис

BOOL ChooseFont
(
LPCHOOSEFONT lpcf // указывает на структуру с данными инициализации
);

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

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

CDERR_FINDRESFAILURECDERR_NOHINSTANCE
CDERR_INITIALIZATIONCDERR_NOHOOK
CDERR_LOCKRESFAILURECDERR_NOTEMPLATE
CDERR_LOADRESFAILURECDERR_STRUCTSIZE
CDERR_LOADSTRFAILURECFERR_MAXLESSTHANMIN
CDERR_MEMALLOCFAILURECFERR_NOFONTS
CDERR_MEMLOCKFAILURE

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

Смотри также
CFHookProc, CHOOSEFONT, CommDlgExtendedError, LOGFONT, WM_CHOOSEFONT_GETLOGFONT, WM_CHOOSEFONT_SETFLAGS, WM_CHOOSEFONT_SETLOGFONT

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

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаcomdlg32.lib
Заголовочный файлcommdlg.h
УникодWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »