Структура CHOOSEFONTA (commdlg.h)

Содержит сведения, которые функция ChooseFont использует для инициализации диалогового окна Шрифт . После того как пользователь закроет диалоговое окно, система возвращает сведения о выборе пользователя в этой структуре.

Синтаксис

typedef struct tagCHOOSEFONTA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HDC          hDC;
  LPLOGFONTA   lpLogFont;
  INT          iPointSize;
  DWORD        Flags;
  COLORREF     rgbColors;
  LPARAM       lCustData;
  LPCFHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
  HINSTANCE    hInstance;
  LPSTR        lpszStyle;
  WORD         nFontType;
  WORD         ___MISSING_ALIGNMENT__;
  INT          nSizeMin;
  INT          nSizeMax;
} CHOOSEFONTA;

Члены

lStructSize

Тип: DWORD

Длина структуры в байтах.

hwndOwner

Тип: HWND

Дескриптор окна, которому принадлежит диалоговое окно. Это может быть любой допустимый дескриптор окна или значение NULL , если у диалогового окна нет владельца.

hDC

Тип: HDC

Этот элемент игнорируется функцией ChooseFont .

Windows Vista и Windows XP/2000: Дескриптор контекста устройства или контекста сведений принтера, шрифты которого будут перечислены в диалоговом окне. Этот элемент используется только в том случае, если элемент Flags указывает флаг CF_PRINTERFONTS или CF_BOTH ; в противном случае этот элемент игнорируется.

lpLogFont

Тип: LPLOGFONT

Указатель на структуру LOGFONT . Если задать флаг CF_INITTOLOGFONTSTRUCT в элементе Flags и инициализировать другие элементы, функция ChooseFont инициализирует диалоговое окно шрифтом, соответствующим элементам LOGFONT . Если пользователь нажимает кнопку ОК , выберите ChooseFont , в зависимости от выбранных пользователем элементов структуры LOGFONT .

iPointSize

Тип: INT

Размер выбранного шрифта в единицах 1/10 точки. Функция ChooseFont задает это значение после того, как пользователь закроет диалоговое окно.

Flags

Тип: DWORD

Набор битовых флагов, которые можно использовать для инициализации диалогового окна Шрифт . Когда диалоговое окно возвращается, оно устанавливает эти флаги для указания введенных пользователем данных. Этот элемент может иметь одно или несколько из следующих значений.

rgbColors

Тип: COLORREF

Если установлен флаг CF_EFFECTS , rgbColors задает начальный цвет текста. При успешном возврате функции ChooseFont этот элемент содержит RGB-значение цвета текста, выбранного пользователем. Чтобы создать значение цвета COLORREF , используйте макрос RGB .

lCustData

Тип: LPARAM

Определяемые приложением данные, которые система передает в процедуру перехватчика, определяемую членом lpfnHook . Когда система отправляет WM_INITDIALOG сообщение в процедуру перехватчика, параметр lParam сообщения является указателем на структуру CHOOSEFONT , указанную при создании диалогового окна. Процедура перехватчика может использовать этот указатель для получения значения lCustData .

lpfnHook

Тип: LPCFHOOKPROC

Указатель на процедуру перехватчика CFHookProc , которая может обрабатывать сообщения, предназначенные для диалогового окна. Этот элемент игнорируется, если флаг CF_ENABLEHOOK не установлен в элементе Flags .

lpTemplateName

Тип: LPCTSTR

Имя ресурса шаблона диалогового окна в модуле, определяемом элементом hInstance . Этот шаблон заменяется стандартным шаблоном диалогового окна. Для нумерованных ресурсов диалогового окна lpTemplateName может быть значением, возвращаемым макросом MAKEINTRESOURCE . Этот элемент игнорируется, если в элементе Flags не установлен флаг CF_ENABLETEMPLATE.

hInstance

Тип: HINSTANCE

Если флаг CF_ENABLETEMPLATEHANDLE установлен в элементе Flags , hInstance — это дескриптор объекта памяти, содержащего шаблон диалогового окна. Если установлен флаг CF_ENABLETEMPLATE , hInstance — это дескриптор модуля, который содержит шаблон диалогового окна с именем члена lpTemplateName . Если ни CF_ENABLETEMPLATEHANDLE , ни CF_ENABLETEMPLATE не заданы, этот элемент игнорируется.

lpszStyle

Тип: LPTSTR

Данные стиля. Если указан флаг CF_USESTYLE , ChooseFont использует данные в этом буфере для инициализации поля со списком Стиль шрифта . Когда пользователь закрывает диалоговое окно, ChooseFont копирует строку в поле со списком Стиль шрифта в этот буфер.

nFontType

Тип: WORD

Тип выбранного шрифта при возврате функции ChooseFont . Этот элемент может иметь одно или несколько из следующих значений.

___MISSING_ALIGNMENT__

nSizeMin

Тип: INT

Наименьший размер в пунктах, который может выбрать пользователь. ChooseFont распознает этот элемент, только если указан флаг CF_LIMITSIZE .

nSizeMax

Тип: INT

Наибольший размер в пунктах, который может выбрать пользователь. ChooseFont распознает этот элемент, только если указан флаг CF_LIMITSIZE .

Комментарии

Требования

См. также раздел

ВыберитеФонт

Общая библиотека диалоговых окон

Основные понятия

MAKEINTRESOURCE

Справочные материалы