CHOOSEFONT  COJPGF 

The CHOOSEFONT structure contains information that the ChooseFont1C8V_VZ 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 LOGFONT5M4ITK structure. If you set the CF_INITTOLOGFONTSTRUCT flag in the Flags member and initialize the LOGFONT members, the ChooseFont1C8V_VZ 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_COMMAND71V.3J messages for the Apply button. The hook procedure can send the WM_CHOOSEFONT_GETLOGFONT4OHK_W message to the dialog box to retrieve the address of the LOGFONT5M4ITK 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 ChooseFont1C8V_VZ 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 LOGFONT5M4ITK 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 ChooseFont1C8V_VZ 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 LOGFONT5M4ITK structure pointed to by the lpLogFont member to initialize the dialog box controls.

CF_LIMITSIZE

Specifies that ChooseFont1C8V_VZ 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 LOGFONT5M4ITK structure is set to DEFAULT_CHARSET when ChooseFont1C8V_VZ 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 LOGFONT5M4ITK 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 ChooseFont1C8V_VZ 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 ChooseFont1C8V_VZ 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 LOGFONT5M4ITK 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 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 ChooseFont1C8V_VZ 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 ChooseFont1C8V_VZ 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_INITDIALOGII1W.B 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 CFHookProc71NX3Z 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 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, ChooseFont1C8V_VZ 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 LOGFONT5M4ITK 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