=for comment based on iup-3.5 - http://www.tecgraf.puc-rio.br/iup/en/dlg/iupmessagedlg.html

=head1 NAME

IUP::MessageDlg - [pre-defined dialog] displaying a message

=head1 DESCRIPTION 

Creates the Message Dialog element. It is a predefined dialog for
displaying a message. The dialog can be shown with the IUP::Popup
function only.

=begin HTML

<p>
  <table border="1">
    <tbody align="center">
      <tr>
        <th>GTK</th>
        <th>Motif</th>
        <th>Windows</th>
      </tr>
      <tr>
        <td><img src="http://kmx.github.io/perl-iup/img-3.9/dlg/messagedlg_gtk.png"></td>
	<td><img src="http://kmx.github.io/perl-iup/img-3.9/dlg/messagedlg_mot.png"></td>
	<td><img src="http://kmx.github.io/perl-iup/img-3.9/dlg/messagedlg_win.png"></td>
      </tr>
    </tbody>
  </table>
</p>

=end HTML

=head1 USAGE

=head2 CREATION - new() method

 $messagedlg = IUP::MessageDlg->new( BUTTONS=>"OKCANCEL" );

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<BUTTONDEFAULT>

Number of the default button. Can be "1" or "2". "2"
is valid only for "OKCANCEL" and "YESNO" button configurations.
Default: "1".

=item B<BUTTONRESPONSE>

Number of the pressed button. Can be "1" or "2".
Default: "1".

=item B<BUTTONS>

Buttons configuration. Can have values: "OK", "OKCANCEL" or
"YESNO". Default: "OK". Additionally the "Help" button is displayed if
the HELP_CB callback is defined.

=item B<DIALOGTYPE>

Type of dialog defines which icon will be displayed
besides the message text. Can have values: "MESSAGE" (No Icon), "ERROR"
(Stop-sign), "WARNING" (Exclamation-point), "QUESTION" (Question-mark)
or "INFORMATION" (Letter "i"). Default: "MESSAGE".

=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. If not defined in Motif the dialog could not be modal.

=item L<TITLE|IUP::Manual::03_Attributes/TITLE>

Dialog title.

=item B<VALUE>

Message text.

=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::MessageDlg|IUP::MessageDlg> is a native pre-defined dialog not altered by
L<SetLanguage|IUP/"SetLanguage()">.

To show the dialog, use function L<Popup|IUP::Manual::02_Elements/"Popup()">.
function.

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 position (x,y) used in L<Popup|IUP::Manual::02_Elements/"Popup()"> is ignored and the
dialog is always centered on screen.

The L<Message|IUP/"Message()"> function simply creates and popup a L<IUP::MessageDlg|IUP::MessageDlg>.

In Windows each different dialog type is always associated with a different beep sound.

In Windows, if PARENTDIALOG is specified then it will be modal relative only to its parent.

=head1 EXAMPLES


The element B<IUP::MessageDlg> is used in the following sample scripts:

=over

=item * L<0-basic/messagedlg.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/messagedlg.pl> - IUP::MessageDlg example

=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<Message|IUP/"Message()">, L<GetParam|IUP/"GetParam()">,
L<ListDialog|IUP/"ListDialog>()">, L<Alarm|IUP/"Alarm()">,
L<GetFile|IUP/"GetFile()">, L<Popup|IUP::Manual::02_Elements/"Popup()">

The original doc: L<iupmessagedlg.html|http://www.tecgraf.puc-rio.br/iup/en/dlg/iupmessagedlg.html>
 

=cut