=for comment based on iup-3.5
=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.com/perl-iup/img-3.5/dlg/messagedlg_gtk.png"></td>
<td><img src="http://kmx.github.com/perl-iup/img-3.5/dlg/messagedlg_mot.png"></td>
<td><img src="http://kmx.github.com/perl-iup/img-3.5/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> (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|http://cpansearch.perl.org/src/KMX/IUP-0.004/examples/0-basic/messagedlg.pl> - IUP::MessageDlg 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