Функция 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 |
Нет |
Замечания по платформе |
Не имеется |