view release on metacpan or  search on metacpan

lib/IUP/MessageDlg.pod  view on Meta::CPAN

=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.305/examples/0-basic/messagedlg.pl> - IUP::MessageDlg example

=item * L<0-basic/pre-dialogs.pl|https://metacpan.org/source/KMX/IUP-0.305/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