To present a font dialog to users, your application must do the following:

• Allocate storage for a FONTDLG data structure and set all fields to NULL.

• Initialize the fields in the FONTDLG data structure.

  The application must do the following:

  a.

  Set the cbSize field to the size of the data structure.
  b.
  Set either the hpsScreen or the hpsPrinter presentation space field, or both. You must have a valid presentation space from which to query fonts.
  c.
  Pass the pointer to a buffer in which to return the family name selected (pszFamilyname) and the size of the buffer (usFamilyBufLen). If the application requires a default font, pass the family name of the font in this buffer. When the first character in pszFamilyName is NULL, no family name is initially selected and the dialog defaults to the system font.
  The application can choose to set the following:

  a.

  An application-specific title. Pass the pointer to a null-terminated string in the pszTitle field.
  b.
  An application-specific preview string. Pass the pointer to a null-terminated string in the pszPreview field.
  c.
  Application-specific available font sizes for outline fonts. Pass the pointer to a null-terminated string containing point sizes, separated by spaces in the pszPtSizeList field.
  d.
  A custom dialog procedure to provide application-specific function. Pass the pointer to a window procedure in the pfnDlgProc field.
  e.
  Set the appropriate FNTS_* flags in the fl field to customize the dialog style.
  f.
  Set the FNTF_NOVIEWPRINTERFONTS or FNTF_NOVIEWSCREENFONTS flags to customize the dialog style when working with printer fonts in the flFlags field. These filter flags should be initialized only when both the hpsScreen and the hpsPrinter presentation space fields are non-NULL.
  g.
  Pass the initial position of the dialog in the x and y fields.
  3.
  Initialize the FONTDLG data structure with any values that users should see when they invoke the dialog for the first time.

  For example, you can pass the following information about the font in these fields of the FONTDLG structure:

  Field

  Font characteristic
  clrBack
  Font background color.
  clrFore
  Font foreground color.
  fl
  Font flags.
  flStyle
  Style bits.
  fxPointSize
  Point size of the font.
  flType
  Selected type bits.
  pszFamilyname
  Family name of the font.
  usWeight
  Font weight.
  usWidth
  Font width.
  The following code fragment shows how to set the fields in the FONTDLG structure:

  FONTDLG fd;                            /* Font dialog structure      */strcpy(szCurrentFont,"Tms Rmn");       /* Times Roman font           */
  memset(&fd,                            /* Storage of the             */
         0,                              /* FONTDLG structure          */
         sizeof(FONTDLG));
  
  fd.cbSize=sizeof(FONTDLG);             /* Size of structure          */
  fd.pszFamilyname=szCurrentFont;        /* Initial font type          */
  fd.fxPointSize=MAKEFIXED(24,0);        /* Initial font to 24 point   */
  fd.usFamilyBufLen=FACESIZE;            /* Family buffer length       */
  fd.clrFore=SYSCLR_WINDOWTEXT;          /* Foreground color           */
  fd.clrBack=SYSCLR_WINDOW;              /* Background color           */
  fd.fl=FNTS_CENTER |                    /* Font flags                 */
        FNTS_INITFROMATTRS;
  
  

  4.
  Invoke the font dialog. Call WinFontDlg and pass the dialog's parent window handle, owner window handle, and a pointer to the initialized FONTDLG data structure.
  5.
  Check the return value from WinFontDlg. If it is successful, the selected font can be used by the application. The information returned in the fAttrs field of the FONTDLG data structure is used.

  ---

  [Back] [Next]