# IupFontDlg

Definition: | include pGUI.e Ihandle ih = IupFontDlg()
Description: | Creates the Font Dialog element. It is a predefined dialog for selecting a font. The dialog can be shown with the IupPopup function only. Returns: the identifier of the created element.
pwa/p2js: | Not supported.
Notes: | The IupFontDlg is a native pre-defined dialog not altered by IupSetLanguage(). To show the dialog, use function IupPopup. The dialog is mapped only inside IupPopup, IupMap does nothing. In Windows, the dialog will be modal relative only to its parent or to the active dialog.
Attributes: |
PREVIEWTEXT | [GTK and Motif only] the text shown in the preview area. If not defined, the system will provide a default text.
COLOR | [Windows Only] The initial color value and the returned selected value if the user pressed the Ok button. In Windows the Choose Font dialog allows the user to select a color from a pre-defined list of colors. Since IUP 3.15 must set SHOWCOLOR=Yes to enable this option.
PARENTDIALOG | (creation only) Name of a dialog to be used as parent. This dialog will be always in front of the parent dialog.
STATUS | (read-only) defined to "1" if the user pressed the Ok button, "0" or NULL if pressed the Cancel button.
TITLE | Dialog title.
VALUE | The initial font value and the selected value returned if the user pressed the Ok button. Has the same format as the FONT attribute.
Callbacks: |
HELP_CB | Action generated when the Help button is pressed.
Example: |
    include pGUI.e

    function help_cb(Ihandle /*ih*/)
        ?"help_cb"
        return IUP_CONTINUE
    end function

    IupOpen(`demo\pGUI\`)
    Ihandln dlg = IupFontDlg();

    IupSetAttribute(dlg, "VALUE", "Times New Roman, Bold 20");
    IupSetAttribute(dlg, "TITLE", "IupFontDlg Test");
    IupSetAttribute(dlg, "SHOWCOLOR","Yes");
    IupSetCallback(dlg, "HELP_CB", Icallback("help_cb"));

    IupPopup(dlg, IUP_CURRENT, IUP_CURRENT);

    if IupGetInt(dlg, "STATUS")!=0 then
      printf(1,"OK\n");
      printf(1,"  VALUE(%s)\n", IupGetAttribute(dlg, "VALUE"));
      printf(1,"  COLOR(%s)\n", IupGetAttribute(dlg, "COLOR"));
    else
      printf(1,"CANCEL\n");
    end if
    dlg = IupDestroy(dlg)
Note that dlg has an Ihandln type for the benefit of IupDestroy(); IupFontDlg() will throw a (catchable) exception rather than return NULL.
See Also: | IupSetAttribute, IupSetCallback, IupPopup, IupGetInt IupDestroy