NAME

IUP::FontDlg - [pre-defined dialog] selecting a font

DESCRIPTION

Creates the Font Dialog element. It is a predefined dialog for selecting a font. The dialog can be shown with the Popup function only.

GTK
Motif
Windows

USAGE

CREATION - new() method

$fontdlg = IUP::FontDlg->new( TITLE=>"Hello" );

Returns: the identifier of the created element, or undef if an error occurs.

NOTE: You can pass to new() other ATTRIBUTE=>'value' or CALLBACKNAME=>\&func pairs relevant to this element - see IUP::Manual::02_Elements.

ATTRIBUTES

For more info about concept of attributes (setting/getting values etc.) see IUP::Manual::03_Attributes. Attributes specific to this element:

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.

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, undef if pressed the Cancel button.

TITLE

Dialog title.

VALUE

The initial font value and the returned selected value if the user pressed the Ok button. Has the same format of the FONT attribute.

CALLBACKS

For more info about concept of callbacks (setting callback handlers etc.) see IUP::Manual::04_Callbacks. Callbacks specific to this element:

HELP_CB

Action generated when the Help button is pressed.

NOTES

The IUP::FontDlg is a native pre-defined dialog not altered by SetLanguage.

To show the dialog, use function Popup.

The dialog is mapped only inside Popup, Map does nothing.

In Windows, the dialog will be modal relative only to its parent or to the active dialog.

EXAMPLES

The element IUP::FontDlg is used in the following sample scripts:

• 0-basic/pre-dialogs.pl - IUP::Expander example

SEE ALSO

IUP::MessageDlg, IUP::FileDlg, Popup

The original doc: iupfontdlg.html