Структура CHOOSEFONTW (commdlg.h)
Содержит сведения, которые использует функция ChooseFont для инициализации диалогового окна шрифта. После закрытия диалогового окна система возвращает сведения о выборе пользователя в этой структуре.
Синтаксис
typedef struct tagCHOOSEFONTW {
DWORD lStructSize;
HWND hwndOwner;
HDC hDC;
LPLOGFONTW lpLogFont;
INT iPointSize;
DWORD Flags;
COLORREF rgbColors;
LPARAM lCustData;
LPCFHOOKPROC lpfnHook;
LPCWSTR lpTemplateName;
HINSTANCE hInstance;
LPWSTR lpszStyle;
WORD nFontType;
WORD ___MISSING_ALIGNMENT__;
INT nSizeMin;
INT nSizeMax;
} CHOOSEFONTW;
Члены
lStructSize
Тип: DWORD
Длина структуры в байтах.
hwndOwner
Тип: HWND
Дескриптор окна, которому принадлежит диалоговое окно. Этот элемент может быть любым допустимым дескриптором окна или может быть null, если диалоговое окно не имеет владельца.
hDC
Тип: HDC
Этот элемент игнорируется функцией ChooseFont.
Windows Vista и Windows XP/2000: дескриптор контекста устройства или контекста сведений принтера, шрифты которого будут перечислены в диалоговом окне. Этот элемент используется только в том случае, если элемент флагов указывает флаг CF_PRINTERFONTS или CF_BOTH; в противном случае этот элемент игнорируется.
lpLogFont
Тип: LPLOGFONT
Указатель на структуру LOGFONT. Если установить флаг CF_INITTOLOGFONTSTRUCT в элементе Flags и инициализировать другие элементы, функция ChooseFont инициализирует диалоговое окно с шрифтом, соответствующим элементам LOGFONT. Если пользователь нажимает кнопку
iPointSize
Тип: INT
Размер выбранного шрифта в единицах 1/10 точки. Функция выбора ChooseFont задает это значение после закрытия диалогового окна пользователем.
Flags
Тип: DWORD
Набор битовых флагов, которые можно использовать для инициализации диалогового окна шрифта
| Ценность | Значение |
|---|---|
|
Вызывает диалоговое окно для отображения кнопки Применить. Необходимо предоставить процедуру перехватчика для обработки сообщений WM_COMMAND для кнопки "Применить". Процедура перехватчика может отправить WM_CHOOSEFONT_GETLOGFONT сообщение в диалоговое окно, чтобы получить адрес структуры, содержащей текущие выделения шрифта. |
|
Этот флаг устарел. Чтобы ограничить выделение шрифтов всеми скриптами, кроме тех, которые используют наборы символов OEM или символов, используйте CF_SCRIPTSONLY. Чтобы получить исходное поведение CF_ANSIONLY, используйте CF_SELECTSCRIPT и укажите ANSI_CHARSET в элементе lfCharSet элемента LOGFONT, на который указывает lpLogFont. |
|
Этот флаг игнорируется для перечисления шрифтов.
Windows Vista и Windows XP/2000: приводит к выводу диалогового окна список доступных шрифтов принтера и экрана. Элемент hDC — это дескриптор контекста устройства или контекста информации, связанного с принтером. Этот флаг представляет собой сочетание флагов CF_SCREENFONTS и CF_PRINTERFONTS. |
|
Вызывает диалоговое окно для отображения элементов управления, позволяющих пользователю указывать параметры нападающего, подчеркивания и цвета текста. Если этот флаг задан, можно использовать элемент rgbColors, чтобы указать исходный цвет текста. Вы можете использовать |
|
Включает процедуру перехватчика, указанную в lpfnHook член этой структуры. |
|
Указывает, что элементы hInstance |
|
Указывает, что элемент hInstance |
|
Выберите Фонт должен перечислять и разрешать выбор только шрифтов фиксированного тона. |
|
SelectFont должно указывать условие ошибки, если пользователь пытается выбрать шрифт или стиль, не указанный в диалоговом окне. |
|
ChooseFont также должен отображать шрифты, которые имеют значение "Скрыть" на панели управления "Шрифты". Windows Vista и Windows XP/2000: этот флаг не поддерживается до Windows 7. |
|
ChooseFont следует использовать структуру, указанную элементом lpLogFont для инициализации элементов управления диалогового окна. |
|
SelectFont должен выбрать только размеры шрифтов в диапазоне, указанном nSizeMin и nSizeMax элементов. |
|
То же, что и флаг CF_NOVECTORFONTS. |
|
При использовании структуры LOGFONT для инициализации элементов управления диалоговым окном используйте этот флаг, чтобы предотвратить отображение начального выбора для поля со списком имени шрифта. Это полезно, если к выделенному тексту не применяется одно имя шрифта. |
|
Отключает поле |
|
ChooseFont не должны отображать или разрешать выбор имитаций шрифтов. |
|
При использовании структуры для инициализации элементов управления диалоговым окном используйте этот флаг, чтобы предотвратить отображение начального выбора для поля со списком размер шрифта. Это полезно при отсутствии одного размера шрифта, применяемого к выделенному тексту. |
|
При использовании структуры LOGFONT для инициализации элементов управления диалогового окна используйте этот флаг, чтобы предотвратить отображение начального выбора для поля со списком шрифта. Это полезно при отсутствии единого стиля шрифта, применяемого к выделенному тексту. |
|
ChooseFont не должны разрешать выбор векторного шрифта. |
|
Приводит к тому, что диалоговое окно шрифта |
|
Этот флаг игнорируется для перечисления шрифтов.
Windows Vista и Windows XP/2000: приводит к тому, что диалоговое окно выводит список только шрифтов, поддерживаемых принтером, связанным с контекстом устройства или контекстом информации, определяемым элементом hDC. Она также приводит к отображению метки описания типа шрифта в нижней части диалогового окна шрифта |
|
Указывает, что ChooseFont должен разрешать только выбор масштабируемых шрифтов. Масштабируемые шрифты включают векторные шрифты, масштабируемые шрифты принтера, шрифты TrueType и шрифты, масштабируемые другими технологиями. |
|
Этот флаг игнорируется для перечисления шрифтов.
Windows Vista и Windows XP/2000: приводит к тому, что диалоговое окно выводит список только шрифтов экрана, поддерживаемых системой. |
|
ChooseFont должен разрешать выбор шрифтов для всех наборов символов, отличных от OEM и символов, а также набора символов ANSI. Это заменяет значение CF_ANSIONLY. |
|
При указании во входных данных отображаются только шрифты с набором символов, определяемых в элементе lfCharSetструктуре LOGFON T. Пользователь не сможет изменить набор символов, указанный в поле со списком Scripts. |
|
Вызывает диалоговое окно для отображения кнопки справки. Элемент |
|
Выбрать Фонт должен перечислять только и разрешать выбор шрифтов TrueType. |
|
Элемент lpszStyle — это указатель на буфер, содержащий данные стиля, которые ChooseFont должны использовать для инициализации поля со списком стиль шрифта. Когда пользователь закрывает диалоговое окно, ChooseFont копирует данные стиля для выбора пользователя в этот буфер.
Примечание Для глобализации приложения необходимо указать стиль с помощью lfWeight и членов структуры LOGFONT, на которую указывает lpLogFont. Имя стиля может измениться в зависимости от языка пользовательского интерфейса системы.
|
|
Устаревший.
ChooseFont игнорирует этот флаг.
Windows Vista и Windows XP/2000: ChooseFont должны разрешать только выбор шрифтов, доступных как на принтере, так и на дисплее. Если этот флаг указан, необходимо также указать флаги CF_SCREENSHOTS и CF_PRINTERFONTSили CF_BOTH. |
rgbColors
Тип: COLORREF
Если установлен флаг CF_EFFECTS, rgbColors задает начальный цвет текста. При успешном возвращении
lCustData
Тип: LPARAM
Определяемые приложением данные, которые система передает процедуре перехватчика, определяемой элементом lpfnHook. Когда система отправляет сообщение WM_INITDIALOG в процедуру перехватчика, параметр lPa ram сообщения является указателем на структуру CHOOSEFONT, указанную при создании диалогового окна. Процедура перехватчика может использовать этот указатель для получения значения lCustData.
lpfnHook
Тип: LPCFHOOKPROC
Указатель на процедуру перехватчика CFHookProc, которая может обрабатывать сообщения, предназначенные для диалогового окна. Этот элемент игнорируется, если флаг CF_ENABLEHOOK не задан в элементе Flags.
lpTemplateName
Тип: LPCTSTR
Имя ресурса шаблона диалогового окна в модуле, определяемом элементом hInstance. Этот шаблон заменен стандартным шаблоном диалогового окна. Для ресурсов нумерованного диалогового окна lpTemplateName может быть значением, возвращаемым макросом MAKEINTRESOURCE. Этот элемент игнорируется, если флаг CF_ENABLETEMPLATE не задан в элементе Flags.
hInstance
Тип: HINSTANCE
Если флаг CF_ENABLETEMPLATEHANDLE задан в элементе Flags, hInstance является дескриптором объекта памяти, содержащего шаблон диалогового окна. Если установлен флаг CF_ENABLETEMPLATE, hInstance — это дескриптор модуля, который содержит шаблон диалогового окна lpTemplateName. Если ни CF_ENABLETEMPLATEHANDLE, ни CF_ENABLETEMPLATE задано, этот элемент игнорируется.
lpszStyle
Тип: LPTSTR
Данные стиля. Если указан флаг CF_USESTYLE, ChooseFont использует данные в этом буфере для инициализации поля со списком шрифта. Когда пользователь закрывает диалоговое окно,
nFontType
Тип: WORD
Тип выбранного шрифта при возврате ChooseFont. Этот элемент может быть одним или несколькими из следующих значений.
| Ценность | Значение |
|---|---|
|
Вес шрифта полужирный. Эта информация дублируется в элементе lfWeight |
|
Задается курсивный атрибут шрифта. Эти сведения дублируются в элементе lfItalic структуры LOGFONT. |
|
Шрифт — это шрифт принтера. |
|
Вес шрифта является нормальным. Эта информация дублируется в элементе |
|
Шрифт — это шрифт экрана. |
|
Шрифт имитируется интерфейсом графического устройства (GDI). |
___MISSING_ALIGNMENT__
nSizeMin
Тип: INT
Минимальный размер точки, который может выбрать пользователь. ChooseFont распознает этот элемент только в том случае, если указан флаг CF_LIMITSIZE.
nSizeMax
Тип: INT
Максимальный размер точки, который может выбрать пользователь. ChooseFont распознает этот элемент только в том случае, если указан флаг CF_LIMITSIZE.
Замечания
Заметка
Заголовок commdlg.h определяет SELECTFONT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| заголовка | commdlg.h |
См. также
библиотека общих диалоговых окон
концептуальные
Справочник