4.36.3.2 - Структура CHOOSEFONT

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

typedef struct 
{    				
	DWORD lStructSize;
	HWND hwndOwner;
	HDC hDC;
	LPLOGFONT lpLogFont;
	INT iPointSize;
	DWORD Flags;
	DWORD rgbColors;
	LPARAM lCustData;
	LPCFHOOKPROC lpfnHook;
	LPCTSTR lpTemplateName;
	HINSTANCE hInstance;
	LPTSTR lpszStyle;
	WORD nFontType;
	WORD ___MISSING_ALIGNMENT__;
	INT nSizeMin;
	INT nSizeMax;
} CHOOSEFONT;

Элементы
lStructSize
Определяет длину структуры в байтах.
hwndOwner
Идентифицирует окно, которое владеет блоком диалога. Этот элемент может быть любым правильным дескриптором окна или он может быть значением ПУСТО (NULL), если у диалогового окна нет владельца.
hDC
Идентифицирует контекст устройства (или информационный контекст) печати, чьи шрифты должны быть внесены в список диалогового окна. Этот элемент используется только тогда, если в элементе Flags установлен флажок CF_PRINTERFONTS или CF_BOTH; в противном случае, этот элемент игнорируется.
lpLogFont
Указатель на структуру LOGFONT. Если вы в элементе Flags установили флажок CF_INITTOLOGFONTSTRUCT и инициализировали элементы LOGFONT, функция ChooseFont инициализирует диалоговое окно со шрифтом, который является наиболее близким возможным соответствием. Если пользователь щелкает по кнопке ОК, ChooseFont устанавливает элементы структуры LOGFONT, основанные на выборе пользователя.
iPointSize
Устанавливает размер выбранного шрифта, в единицах 1/10 пункта. Функция ChooseFon устанавливает это значение после того, как пользователь закроет диалоговое окно
Flags
Установка битов флажков, которые вы можете использовать, чтобы инициализировать стандартное диалоговое окно Шрифт (Font). Когда диалоговое окно возвращает значение, оно устанавливает эти флажки, чтобы показать вводимые данные пользователем. Этот элемент может быть комбинацией следующих флажков:

rgbColors
Если установлен флажок CF_EFFECTS, rgbColors определяет начальный цвет текста. Когда функция ChooseFont успешно возвращает значение, этот элемент содержит значение RGB цвета текста, который выбрал пользователь.
lCustData
Устанавливает определяемые программой данные, которые система передает в фильтр - процедуру, идентифицированную элементом lpfnHook. Когда система передает сообщение WM_INITDIALOG фильтр - процедуре, параметр сообщения lParam - указатель на структуру CHOOSEFONT, определенную, когда диалоговое окно было создано. Фильтр - процедура может использовать этот указатель, чтобы получить значение lCustData.
lpfnHook
Указатель на фильтр - процедуру CFHookProc, которая может обрабатывать сообщения, предназначенные для диалогового окна. Этот элемент игнорируется, если в элементе Flags не установлен флажок CF_ENABLEHOOK.
LpTemplateName
Указатель на строку с символом нуля в конце, который именует ресурс шаблона диалогового окна в модуле, идентифицированном элементом hInstance. Этот шаблон заменяет стандартный шаблон диалогового окна. Для пронумерованных ресурсов блока диалога, lpTemplateName может быть значением, возвращенным макрокомандой MAKEINTRESOURCE. Этот элемент игнорируется, если в элементе Flags не установлен флажок CF_ENABLETEMPLATE.
hInstance
Если в элементе Flags установлен флажок CF_ENABLETEMPLATEHANDLE, hInstance - дескриптор объекта памяти, содержащего шаблон диалогового окна. Если установлен флажок CF_ENABLETEMPLATE, hInstance идентифицирует модуль, который содержит шаблон диалогового окна, именованный элементом lpTemplateName. Если ни CF_ENABLETEMPLATEHANDLE ни CF_ENABLETEMPLATE не установлен, этот элемент игнорируется.
lpszStyle
Указатель на буфер, который содержит данные стиля. Если установлен флажок CF_USESTYLE, функция ChooseFont использует данные в этом буфере, чтобы инициализировать стиль шрифта комбинированного блока диалога. Когда пользователь закрывает диалоговое окно, ChooseFont в этот буфер копирует строку стиля шрифта в комбинированном блоке диалога.
nFontType
Определяет тип выбранного шрифта, когда ChooseFont возвращает значение. Этот элемент может быть комбинацией следующих значений:

nSizeMin
Определяет минимальный размер шрифта в пунктах, который пользователь может выбирать. Функция ChooseFont распознает этот элемент только в том случае, если установлен флажок CF_LIMITSIZE.
nSizeMax
Определяет максимальный размер шрифта в пунктах, который пользователь может выбирать. Функция ChooseFont распознает этот элемент только в том случае, если установлен флажок CF_LIMITSIZE.

Смотри также
ChooseFont, LOGFONT, MAKEINTRESOURCE

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

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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков.