=for comment based on iup-3.5 - http://www.tecgraf.puc-rio.br/iup/en/dlg/iupfontdlg.html
=head1 NAME
IUP::FontDlg - [pre-defined dialog] selecting a font
=head1 DESCRIPTION
Creates the Font Dialog element. It is a predefined dialog for
selecting a font. The dialog can be shown with the L<Popup|IUP::Manual::02_Elements/"Popup()"> function
only.
=begin HTML
<p>
<table border="1">
<tbody align="center">
<col style="text-align: center;">
<col style="text-align: left;">
<tr>
<th>GTK</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/dlg/fontdlg_gtk.png"></td>
</tr>
<tr>
<th>Motif</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/dlg/fontdlg_mot.png"></td>
</tr>
<tr>
<th>Windows</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/dlg/fontdlg_win.png"></td>
</tr>
</tbody>
</table>
</p>
=end HTML
=head1 USAGE
=head2 CREATION - new() method
$fontdlg = IUP::FontDlg->new( TITLE=>"Hello" );
B<Returns:> the identifier of the created element, or C<undef> if an error occurs.
NOTE: You can pass to C<new()> other C<ATTRIBUTE=E<gt>'value'> or C<CALLBACKNAME=E<gt>\&func> pairs relevant
to this element - see L<IUP::Manual::02_Elements|IUP::Manual::02_Elements/"new()">.
=head2 ATTRIBUTES
For more info about concept of attributes (setting/getting values etc.)
see L<IUP::Manual::03_Attributes|IUP::Manual::03_Attributes>. Attributes specific to this element:
=over
=item B<PREVIEWTEXT>
I<[GTK and Motif only]> the text shown in the preview
area. If not defined the system will provide a default text.
=item B<COLOR>
I<[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.
=item L<PARENTDIALOG|IUP::Manual::03_Attributes/PARENTDIALOG>
I<(creation only)> Name of a dialog to be used as parent. This dialog will be always in front
of the parent dialog.
=item B<STATUS>
I<(read-only)> Defined to "1" if the user pressed the Ok
button, C<undef> if pressed the Cancel button.
=item L<TITLE|IUP::Manual::03_Attributes/TITLE>
Dialog title.
=item B<VALUE>
The initial font value and the returned selected value if the
user pressed the Ok button. Has the same format of the
L<FONT|IUP::Manual::03_Attributes/FONT> attribute.
=back
=head2 CALLBACKS
For more info about concept of callbacks (setting callback handlers etc.)
see L<IUP::Manual::04_Callbacks|IUP::Manual::04_Callbacks>. Callbacks specific to this element:
=over
=item L<HELP_CB|IUP::Manual::04_Callbacks/HELP_CB>
Action generated when the Help button is pressed.
=back
=head1 NOTES
The L<IUP::FontDlg|IUP::FontDlg> is a native pre-defined dialog not altered by
L<SetLanguage|IUP/"SetLanguage()">.
To show the dialog, use function L<Popup|IUP/"Popup()">.
The dialog is mapped only inside L<Popup|IUP::Manual::02_Elements/"Popup()">, L<Map|IUP::Manual::02_Elements/"Map()"> does nothing.
In Windows, the dialog will be modal relative only to its parent or to
the active dialog.
=head1 EXAMPLES
The element B<IUP::FontDlg> is used in the following sample scripts:
=over
=item * L<0-basic/pre-dialogs.pl|https://metacpan.org/source/KMX/IUP-0.201/examples/0-basic/pre-dialogs.pl> - IUP::Expander example
=back
=head1 SEE ALSO
L<IUP::MessageDlg|IUP::MessageDlg>, L<IUP::FileDlg|IUP::FileDlg>,
L<Popup|IUP::Manual::02_Elements/"Popup()">
The original doc: L<iupfontdlg.html|http://www.tecgraf.puc-rio.br/iup/en/dlg/iupfontdlg.html>
=cut