=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.303/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