CHOOSEFONT
The CHOOSEFONT
structure contains information that the ChooseFont
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
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 |
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 |
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 |
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 |
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 |
CF_LIMITSIZE |
Specifies
that ChooseFont |
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 |
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 |
CF_NOSIMULATIONS |
Specifies
that ChooseFont |
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 |
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 |
CF_SHOWHELP |
Causes the
dialog box to display the Help button. The hwndOwner member must
specify the window to receive the HELPMSGSTRING1N5CG6 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 |
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
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
lpfnHook
Pointer to a CFHookProc
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 MAKEINTRESOURCEXFOY9_ 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
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 |
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