Next: Gtk2::Misc | Previous: Gtk2::MenuToolButton | [Gtk2-Perl - Table of Contents] | [Gtk2-Perl - Index] |
Gtk2::MessageDialog
# # A modal dialog. Note that the message is a printf-style format. # $dialog = Gtk2::MessageDialog->new ($main_application_window, 'destroy-with-parent', 'question', # message type 'yes-no', # which set of buttons? "Pay me $%.2f?", $amount); $response = $dialog->run; if ($response eq 'yes') { send_bill (); } $dialog->destroy; # # A non-modal dialog. # $dialog = Gtk2::MessageDialog->new ($main_application_window, 'destroy-with-parent', 'question', # message type 'ok-cancel', # which set of buttons? "Self-destruct now?"); # react whenever the user responds. $dialog->signal_connect (response => sub { my ($self, $response) = @_; if ($response eq 'ok') { do_the_thing (); } $self->destroy; }); $dialog->show_all;
Gtk2::MessageDialog is a dialog with an image representing the type of message (Error, Question, etc.) alongside some message text. It's simply a convenience widget; you could construct the equivalent of Gtk2::MessageDialog from Gtk2::Dialog without too much effort, but Gtk2::MessageDialog saves typing and helps create a consistent look and feel for your application.
The easiest way to do a modal message dialog is to use $dialog->run
, which
automatically makes your dialog modal and waits for the user to respond to it.
You can also pass in the GTK_DIALOG_MODAL flag when creating the MessageDialog.
Glib::Object +----Glib::InitiallyUnowned +----Gtk2::Object +----Gtk2::Widget +----Gtk2::Container +----Gtk2::Bin +----Gtk2::Window +----Gtk2::Dialog +----Gtk2::MessageDialog
Glib::Object::_Unregistered::AtkImplementorIface Gtk2::Buildable
$parent (Gtk2::Window or undef)
$flags (Gtk2::DialogFlags)
$type (Gtk2::MessageType)
$buttons (Gtk2::ButtonsType)
$format (scalar)
... (list)
$parent (Gtk2::Window or undef)
$flags (Gtk2::DialogFlags)
$type (Gtk2::MessageType)
$buttons (Gtk2::ButtonsType)
$message (string or undef) a string containing Pango markup
Like new
, but allowing Pango markup tags in the message. Note that this
version is not variadic.
Since: gtk+ 2.4
Since: gtk+ 2.6
Since: gtk+ 2.6
Since: gtk+ 2.10
Since: gtk+ 2.4
'none' / 'GTK_BUTTONS_NONE'
'ok' / 'GTK_BUTTONS_OK'
'close' / 'GTK_BUTTONS_CLOSE'
'cancel' / 'GTK_BUTTONS_CANCEL'
'yes-no' / 'GTK_BUTTONS_YES_NO'
'ok-cancel' / 'GTK_BUTTONS_OK_CANCEL'
'modal' / 'GTK_DIALOG_MODAL'
'destroy-with-parent' / 'GTK_DIALOG_DESTROY_WITH_PARENT'
'no-separator' / 'GTK_DIALOG_NO_SEPARATOR'
'info' / 'GTK_MESSAGE_INFO'
'warning' / 'GTK_MESSAGE_WARNING'
'question' / 'GTK_MESSAGE_QUESTION'
'error' / 'GTK_MESSAGE_ERROR'
'other' / 'GTK_MESSAGE_OTHER'
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::Window, Gtk2::Dialog
Copyright (C) 2003-2008 by the gtk2-perl team.
This software is licensed under the LGPL. See Gtk2 for a full notice.