CHOOSEFONTA structure (commdlg.h)
Contains information that the ChooseFont function uses to initialize the Font dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure.
Syntax
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;
Members
lStructSize
Type: DWORD
The length of the structure, in bytes.
hwndOwner
Type: HWND
A handle to 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
Type: HDC
This member is ignored by the ChooseFont function.
Windows Vista and Windows XP/2000: A handle to 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
Type: LPLOGFONT
A pointer to a LOGFONT structure. If you set the CF_INITTOLOGFONTSTRUCT flag in the Flags member and initialize the other members, the ChooseFont function initializes the dialog box with a font that matches the LOGFONT members. If the user clicks the OK button, ChooseFont sets the members of the LOGFONT structure based on the user's selections.
iPointSize
Type: INT
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
Type: DWORD
A set of bit flags that you can use to initialize the Font dialog box. When the dialog box returns, it sets these flags to indicate the user input. This member can be one or more of the following values.
| Value | Meaning |
|---|---|
|
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 structure that contains the current selections for the font. |
|
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 original CF_ANSIONLY behavior, use CF_SELECTSCRIPT and specify ANSI_CHARSET in the lfCharSet member of the LOGFONT structure pointed to by lpLogFont. |
|
This flag is ignored for font enumeration.
Windows Vista and Windows XP/2000: Causes the dialog box to list the available printer and screen fonts. The hDC member is a handle to the device context or information context associated with the printer. This flag is a combination of the CF_SCREENFONTS and CF_PRINTERFONTS flags. |
|
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 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. |
|
Enables the hook procedure specified in the lpfnHook member of this structure. |
|
Indicates that the hInstance and lpTemplateName members specify a dialog box template to use in place of the default template. |
|
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. |
|
ChooseFont should enumerate and allow selection of only fixed-pitch fonts. |
|
ChooseFont should indicate an error condition if the user attempts to select a font or style that is not listed in the dialog box. |
|
ChooseFont should additionally display fonts that are set to Hide in Fonts Control Panel. Windows Vista and Windows XP/2000: This flag is not supported until Windows 7. |
|
ChooseFont should use the structure pointed to by the lpLogFont member to initialize the dialog box controls. |
|
ChooseFont should select only font sizes within the range specified by the nSizeMin and nSizeMax members. |
|
Same as the CF_NOVECTORFONTS flag. |
|
When using a LOGFONT structure to initialize the dialog box controls, use this flag to 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. |
|
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. |
|
ChooseFont should not display or allow selection of font simulations. |
|
When using a structure to initialize the dialog box controls, use this flag to 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. |
|
When using a LOGFONT structure to initialize the dialog box controls, use this flag to 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. |
|
ChooseFont should not allow vector font selections. |
|
Causes the Font dialog box to list only horizontally oriented fonts. |
|
This flag is ignored for font enumeration.
Windows Vista and Windows XP/2000: 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. It also causes the font type description label to appear at the bottom of the Font dialog box. |
|
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. |
|
This flag is ignored for font enumeration.
Windows Vista and Windows XP/2000: Causes the dialog box to list only the screen fonts supported by the system. |
|
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. |
|
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. |
|
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. |
|
ChooseFont should only enumerate and allow the selection of TrueType fonts. |
|
The lpszStyle member is a pointer 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.
Note To globalize your application, you should specify the style by using the lfWeight and lfItalic members of the LOGFONT structure pointed to by lpLogFont. The style name may change depending on the system user interface language.
|
|
Obsolete. ChooseFont ignores this flag.
Windows Vista and Windows XP/2000: ChooseFont should allow only the selection of fonts available on both the printer and the display. If this flag is specified, the CF_SCREENSHOTS and CF_PRINTERFONTS, or CF_BOTH flags should also be specified. |
rgbColors
Type: COLORREF
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 that the user selected. To create a COLORREF color value, use the RGB macro.
lCustData
Type: LPARAM
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
Type: LPCFHOOKPROC
A 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
Type: LPCTSTR
The name of 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
Type: HINSTANCE
If the CF_ENABLETEMPLATEHANDLE flag is set in the Flags member, hInstance is a handle to a memory object containing a dialog box template. If the CF_ENABLETEMPLATE flag is set, hInstance is a handle to 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
Type: LPTSTR
The 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
Type: WORD
The type of the selected font when ChooseFont returns. This member can be one or more of the following values.
| Value | Meaning |
|---|---|
|
The font weight is bold. This information is duplicated in the lfWeight member of the LOGFONT structure and is equivalent to FW_BOLD. |
|
The italic font attribute is set. This information is duplicated in the lfItalic member of the LOGFONT structure. |
|
The font is a printer font. |
|
The font weight is normal. This information is duplicated in the lfWeight member of the LOGFONT structure and is equivalent to FW_REGULAR. |
|
The font is a screen font. |
|
The font is simulated by the graphics device interface (GDI). |
___MISSING_ALIGNMENT__
nSizeMin
Type: INT
The minimum point size a user can select. ChooseFont recognizes this member only if the CF_LIMITSIZE flag is specified.
nSizeMax
Type: INT
The maximum point size a user can select. ChooseFont recognizes this member only if the CF_LIMITSIZE flag is specified.
Remarks
Note
The commdlg.h header defines CHOOSEFONT as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | commdlg.h |
See also
Conceptual
Reference