На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

CHOOSEFONT



The CHOOSEFONT structure contains information that the ChooseFont function uses to initialize the Font common dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure.

typedef struct { // cf
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;


Members

lStructSize

Specifies the length, in bytes, of the structure.

hwndOwner

Identifies the window that owns the dialog box. This member can be any valid window handle, or it can be NULL if the dialog box has no owner.

hDC

Identifies the device context (or information context) of the printer whose fonts will be listed in the dialog box. This member is used only if the Flags member specifies the CF_PRINTERFONTS or CF_BOTH flag; otherwise, this member is ignored.

lpLogFont

Pointer to a LOGFONT structure. If you set the CF_INITTOLOGFONTSTRUCT flag in the Flags member and initialize the LOGFONT members, the ChooseFont function initializes the dialog box with a font that is the closest possible match. If the user clicks the OK button, ChooseFont sets the members of the LOGFONT structure based on the user's selections.

iPointSize

Specifies the size of the selected font, in units of 1/10 of a point. The ChooseFont function sets this value after the user closes the dialog box.

Flags

A set of bit flags that you can use to initialize the Font common dialog box. When the dialog box returns, it sets these flags to indicate the user's input. This member can be a combination of the following flags:

Flag Meaning
CF_APPLY Causes the dialog box to display the Apply button. You should provide a hook procedure to process WM_COMMAND messages for the Apply button. The hook procedure can send the WM_CHOOSEFONT_GETLOGFONT message to the dialog box to retrieve the address of the LOGFONT structure that contains the current selections for the font.
CF_ANSIONLY This flag is obsolete. To limit font selections to all scripts except those that use the OEM or Symbol character sets, use CF_SCRIPTSONLY. To get the Windows 3.1 CF_ANSIONLY behavior, use CF_SELECTSCRIPT and specify ANSI_CHARSET in the lfCharSet member of the LOGFONT structure pointed to by lpLogFont.
CF_BOTH Causes the dialog box to list the available printer and screen fonts. The hDC member identifies the device context (or information context) associated with the printer. This flag is a combination of the CF_SCREENFONTS and CF_PRINTERFONTS flags.
CF_TTONLY Specifies that ChooseFont should only enumerate and allow the selection of TrueType fonts.
CF_EFFECTS Causes the dialog box to display the controls that allow the user to specify strikeout, underline, and text color options. If this flag is set, you can use the rgbColors member to specify the initial text color. You can use the lfStrikeOut and lfUnderline members of the LOGFONT structure pointed to by lpLogFont to specify the initial settings of the strikeout and underline check boxes. ChooseFont can use these members to return the user's selections.
CF_ENABLEHOOK Enables the hook procedure specified in the lpfnHook member of this structure.
CF_ENABLETEMPLATE Indicates that the hInstance and lpTemplateName members specify a dialog box template to use in place of the default template.
CF_ENABLETEMPLATEHANDLE Indicates that the hInstance member identifies a data block that contains a preloaded dialog box template. The system ignores the lpTemplateName member if this flag is specified.
CF_FIXEDPITCHONLY Specifies that ChooseFont should select only fixed-pitch fonts.
CF_FORCEFONTEXIST Specifies that ChooseFont should indicate an error condition if the user attempts to select a font or style that does not exist.
CF_INITTOLOGFONTSTRUCT Specifies that ChooseFont should use the LOGFONT structure pointed to by the lpLogFont member to initialize the dialog box controls.
CF_LIMITSIZE Specifies that ChooseFont should select only font sizes within the range specified by the nSizeMin and nSizeMax members.
CF_NOOEMFONTS Same as the CF_NOVECTORFONTS flag.
CF_NOFACESEL When using a LOGFONT structure to initialize the dialog box controls, use this flag to selectively prevent the dialog box from displaying an initial selection for the font name combo box. This is useful when there is no single font name that applies to the text selection.
CF_NOSCRIPTSEL Disables the Script combo box. When this flag is set, the lfCharSet member of the LOGFONT structure is set to DEFAULT_CHARSET when ChooseFont returns. This flag is used only to initialize the dialog box.
CF_NOSTYLESEL When using a LOGFONT structure to initialize the dialog box controls, use this flag to selectively prevent the dialog box from displaying an initial selection for the font style combo box. This is useful when there is no single font style that applies to the text selection.
CF_NOSIZESEL When using a LOGFONT structure to initialize the dialog box controls, use this flag to selectively prevent the dialog box from displaying an initial selection for the font size combo box. This is useful when there is no single font size that applies to the text selection.
CF_NOSIMULATIONS Specifies that ChooseFont should not allow graphics device interface (GDI) font simulations.
CF_NOVECTORFONTS Specifies that ChooseFont should not allow vector font selections.
CF_NOVERTFONTS Causes the Font dialog box to list only horizontally oriented fonts.
CF_PRINTERFONTS Causes the dialog box to list only the fonts supported by the printer associated with the device context (or information context) identified by the hDC member.
CF_SCALABLEONLY Specifies that ChooseFont should allow only the selection of scalable fonts. (Scalable fonts include vector fonts, scalable printer fonts, TrueType fonts, and fonts scaled by other technologies.)
CF_SCREENFONTS Causes the dialog box to list only the screen fonts supported by the system.
CF_SCRIPTSONLY Specifies that ChooseFont should allow selection of fonts for all non-OEM and Symbol character sets, as well as the ANSI character set. This supersedes the CF_ANSIONLY value.
CF_SELECTSCRIPT When specified on input, only fonts with the character set identified in the lfCharSet member of the LOGFONT structure are displayed. The user will not be allowed to change the character set specified in the Scripts combo box.
CF_SHOWHELP Causes the dialog box to display the Help button. The hwndOwner member must specify the window to receive the HELPMSGSTRING registered messages that the dialog box sends when the user clicks the Help button.
CF_USESTYLE Specifies that the lpszStyle member points to a buffer that contains style data that ChooseFont should use to initialize the Font Style combo box. When the user closes the dialog box, ChooseFont copies style data for the user's selection to this buffer.
CF_WYSIWYG Specifies that ChooseFont should allow only the selection of fonts available on both the printer and the display. If this flag is specified, the CF_BOTH and CF_SCALABLEONLY flags should also be specified.


rgbColors

If the CF_EFFECTS flag is set, rgbColors specifies the initial text color. When ChooseFont returns successfully, this member contains the RGB value of the text color the user selected.

lCustData

Specifies application-defined data that the system passes to the hook procedure identified by the lpfnHook member. When the system sends the WM_INITDIALOG message to the hook procedure, the message's lParam parameter is a pointer to the CHOOSEFONT structure specified when the dialog was created. The hook procedure can use this pointer to get the lCustData value.

lpfnHook

Pointer to a CFHookProc hook procedure that can process messages intended for the dialog box. This member is ignored unless the CF_ENABLEHOOK flag is set in the Flags member.

lpTemplateName

Pointer to a null-terminated string that names the dialog box template resource in the module identified by the hInstance member. This template is substituted for the standard dialog box template. For numbered dialog box resources, lpTemplateName can be a value returned by the MAKEINTRESOURCE macro. This member is ignored unless the CF_ENABLETEMPLATE flag is set in the Flags member.

hInstance

If the CF_ENABLETEMPLATEHANDLE flag is set in the Flags member, hInstance is the handle of a memory object containing a dialog box template. If the CF_ENABLETEMPLATE flag is set, hInstance identifies a module that contains a dialog box template named by the lpTemplateName member. If neither CF_ENABLETEMPLATEHANDLE nor CF_ENABLETEMPLATE is set, this member is ignored.

lpszStyle

Pointer to a buffer that contains style data. If the CF_USESTYLE flag is specified, ChooseFont uses the data in this buffer to initialize the font style combo box. When the user closes the dialog box, ChooseFont copies the string in the font style combo box into this buffer.

nFontType

Specifies the type of the selected font when ChooseFont returns. This member can be a combination of the following values:

Value Meaning
BOLD_FONTTYPE The font weight is bold. This information is duplicated in the lfWeight member of the LOGFONT structure and is equivalent to FW_BOLD.
ITALIC_FONTTYPE The italic font attribute is set. This information is duplicated in the lfItalic member of the LOGFONT structure.
PRINTER_FONTTYPE The font is a printer font.
REGULAR_FONTTYPE The font weight is normal. This information is duplicated in the lfWeight member of the LOGFONT structure and is equivalent to FW_REGULAR.
SCREEN_FONTTYPE The font is a screen font.
SIMULATED_FONTTYPE The font is simulated by the graphics device interface (GDI).


nSizeMin

Specifies the minimum point size a user can select. ChooseFont recognizes this member only if the CF_LIMITSIZE flag is specified.

nSizeMax

Specifies the maximum point size a user can select. ChooseFont recognizes this member only if the CF_LIMITSIZE flag is specified.



See Also

ChooseFont, LOGFONT, MAKEINTRESOURCE


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

CHOOSEFONT



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

typedef struct { // ср. DWORD lStructSize;
HWND hwndOwner;
HDC hDC;
LPLOGFONT lpLogFont;
INT iPointSize;
DWORD СИГНАЛИЗИРУЕТ;
DWORD rgbColors;
LPARAM lCustData;
LPCFHOOKPROC lpfnHook;
LPCTSTR lpTemplateName;
hInstance HINSTANCE;
LPTSTR lpszStyle;
СЛОВО nFontType;
СЛОВО ___MISSING_ALIGNMENT__;
INT nSizeMin;

INT nSizeMax;
} CHOOSEFONT;


Участники

lStructSize

Определяет длину, в байтах, структуры.

hwndOwner

Идентифицирует окно, которое обладает диалоговым блоком. Этот элемент может быть любой правильной ручкой окна, или это может быть НЕДЕЙСТВИТЕЛЬНО если диалоговый блок не имеет владельца.

hDC

Идентифицирует контекст устройства (или информационного контекста) принтера чьи шрифты будут указаны в диалоговом блоке. Этот элемент используется только если элемент Флагов определяет CF_PRINTERFONTS или флаг CF_BOTH; в противном случае, этот элемент проигнорирован.

lpLogFont

Указатель в структуру LOGFONT. Если Вы установили бы флаг CF_INITTOLOGFONTSTRUCT в элементе Флагов и инициализировали участников LOGFONT, функция ChooseFont инициализирует диалогового блока с шрифтом, который - ближайшее возможное сопоставление. Если пользователь щелкает кнопку OK, ChooseFont устанавливает участников структуры LOGFONT основанной на выборах пользователя.

iPointSize

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

Флаги

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

Значение Флага
CF_APPLY Заставляет диалогового блока, чтобы отображать кнопку Apply. Вы должны обеспечить рычажную процедуру, чтобы обрабатывать сообщения WM_COMMAND для кнопки Apply. Рычажная процедура может послать сообщение WM_CHOOSEFONT_GETLOGFONT диалоговому блоку, чтобы извлекать адрес структуры LOGFONT, которая содержит текущие выборы для шрифта.
CF_ANSIONLY Этого флага устаревший. Для того, чтобы ограничивать шрифтовые выборы во все сценарии кроме те которые используют OEM или наборы символов Символа, используйте CF_SCRIPTSONLY. Для того, чтобы получать поведение Windows 3.1 CF_ANSIONLY, используйте CF_SELECTSCRIPT и определяйте ANSI_CHARSET в элементе lfCharSet структуры LOGFONT указанной, чтобы lpLogFont.
CF_BOTH Заставляет диалогового блока, чтобы указывать доступный принтер и отгораживать шрифты. Элемент hDC идентифицирует контекст устройства (или информационного контекста) связанные принтером. Этот флаг - комбинация CF_SCREENFONTS и флагов CF_PRINTERFONTS.
CF_TTONLY Определяет, что ChooseFont должен только перечислить и допускать выбор шрифтов TrueType.
CF_EFFECTS Заставляет диалогового блока, чтобы отображать элементы управления, которые позволяют пользователя, чтобы определять разрядку, подчеркивать, и текстовые цветные опции. Если этот флаг установлен, Вы можете использовать элемент rgbColors, чтобы определять начальный текстовый цвет. Вы можете использовать lfStrikeOut и участники lfUnderline структуры LOGFONT указывались, чтобы lpLogFont, чтобы определять начальные установочные параметры разрядки и подчеркивать контрольных блоков. ChooseFont МОЖЕТ использовать этих участников, чтобы возвращать выборы пользователя.
CF_ENABLEHOOK Приспосабливается рычажную процедуру определенную в элементе lpfnHook этой структуры.
CF_ENABLETEMPLATE Указывает, что hInstance и участники lpTemplateName определяют диалоговый шаблон блока, чтобы использоваться вместо по умолчанию шаблона.
CF_ENABLETEMPLATEHANDLE Указывает, что элемент hInstance идентифицирует блока данных, который содержит натянутый предварительно диалоговый шаблон блока. Система игнорирует элемент lpTemplateName если этот флаг определен.
CF_FIXEDPITCHONLY Определяет, что ChooseFont должен выбираться только фиксированный шаг шрифтов.
CF_FORCEFONTEXIST Определяет, что ChooseFont должен указать условие ошибки если пользователь пытается выбираться шрифт или стиль, что не существует.
CF_INITTOLOGFONTSTRUCT Определяет, что ChooseFont должен использовать структуру LOGFONT указанную, чтобы элементом lpLogFont, чтобы инициализировать диалоговые элементы управления блока.
CF_LIMITSIZE Определяет, что ChooseFont должен выбираться только шрифтовые размеры в пределах дипазона определенного nSizeMin и участниками nSizeMax.
CF_NOOEMFONTS Также, как флаг CF_NOVECTORFONTS.
CF_NOFACESEL При использовании структуры LOGFONT, чтобы инициализировать диалоговые элементы управления блока, использовать этот флаг, чтобы выборочно предохранять диалогового блока от отображения начального выбора для шрифтового имени combo блок. Это полезное когда нет единственного шрифтового имени, которое относится к текстовому выбору.
CF_NOSCRIPTSEL Выводит из строя Сценарий combo блок. Когда этот флаг установлен, элемент lfCharSet структуры LOGFONT установлен на DEFAULT_CHARSET когда возврат ChooseFont. Этот флаг используется только, чтобы инициализировать диалогового блока.
CF_NOSTYLESEL При использовании структуры LOGFONT, чтобы инициализировать диалоговые элементы управления блока, использовать этот флаг, чтобы выборочно предохранять диалогового блока от отображения начального выбора для шрифтового стиля combo блок. Это полезное когда нет единственного шрифтового стиля, который относится к текстовому выбору.
CF_NOSIZESEL При использовании структуры LOGFONT, чтобы инициализировать диалоговые элементы управления блока, использовать этот флаг, чтобы выборочно предохранять диалогового блока от отображения начального выбора для шрифтового размера combo блок. Это полезное когда нет единственного шрифтового размера, который относится к текстовому выбору.
CF_NOSIMULATIONS Определяет, что ChooseFont не должен допускать графический интерфейс устройства (GDI) шрифтовые моделирования.
CF_NOVECTORFONTS Определяет, что ChooseFont не должен допускать векторные шрифтовые выборы.
CF_NOVERTFONTS Заставляет диалогового блока Шрифта, чтобы указывать только горизонтально сориентировавшее шрифты.
CF_PRINTERFONTS Заставляет диалогового блока, чтобы указывать только шрифты поддерживанные принтером связанным контекстом устройства (или информационного контекста) идентифицированными элементом hDC.
CF_SCALABLEONLY Определяет, что ChooseFont должен допустить только выбор масштабируемых шрифтов. (Масштабируемые шрифты включают векторные шрифты, масштабируемые шрифты принтера, шрифтов TrueType, и шрифты масштабировались другими технологиями.)
CF_SCREENFONTS Заставляет диалогового блока, чтобы указывать только экранные шрифты поддерживанные системой.
CF_SCRIPTSONLY Определяет, что ChooseFont должен допустить выбор шрифтов для всех не-OEM и наборов символов Символа, а также набор символов ANSI. Это заменяет величину CF_ANSIONLY.
CF_SELECTSCRIPT Когда определено на вводе, только шрифты с набором символов идентифицированным в элементе lfCharSet структуры LOGFONT отображены. Пользователь не будет позволен изменять набор символов определенный в Сценариях combo блок.
CF_SHOWHELP Заставляет диалогового блока, чтобы отображать кнопку Подсказки. Элемент hwndOwner должен определить окно, чтобы получать HELPMSGSTRING зарегистрировавшее сообщения, что диалоговый блок посылает когда пользователь щелкает кнопку Подсказки.
CF_USESTYLE Определяет, что элемент lpszStyle указывает на буфер, который содержит данные стиля, что ChooseFont должен использоваться, чтобы инициализировать Шрифтовой Стиль combo блок. Когда пользователь закрывает диалогового блока, данных стиля копий ChooseFont для выбора пользователя в этот буфер.
CF_WYSIWYG Определяет, что ChooseFont должен допустить только выбор шрифтов доступных как в принтере так и дисплей. Если этот флаг определен, CF_BOTH и флаги CF_SCALABLEONLY должны также определены.


rgbColors

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

lCustData

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

lpfnHook

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

lpTemplateName

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

hInstance

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

lpszStyle

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

nFontType

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

Значение Величины
BOLD_FONTTYPE шрифтовой вес смелый. Эта информация продублирована в элементе lfWeight структуры LOGFONT и - эквивалент FW_BOLD.
ITALIC_FONTTYPE шрифтовой атрибут курсива установлен. Эта информация продублирована в элементе lfItalic структуры LOGFONT.
PRINTER_FONTTYPE шрифт является шрифтом принтера.
REGULAR_FONTTYPE шрифтовой вес нормальный. Эта информация продублирована в элементе lfWeight структуры LOGFONT и - эквивалент FW_REGULAR.
SCREEN_FONTTYPE шрифт является экранным шрифтом.
SIMULATED_FONTTYPE шрифт сымитирован графическим интерфейсом устройства (GDI).


nSizeMin

Определяет минимальный размер точки, что пользователь может выбраться. ChooseFont ПРИЗНАЕТ этот элемент только если флаг CF_LIMITSIZE определен.

nSizeMax

Определяет максимальный размер точки, что пользователь может выбраться. ChooseFont ПРИЗНАЕТ этот элемент только если флаг CF_LIMITSIZE определен.



Смотри Также

ChooseFont, LOGFONT, MAKEINTRESOURCE


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz