Gtk2::MessageDialog3pm
Wrapper for gtkmessagedialog
Usage
## 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;
Overview
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.
Hierarchy
Glib::Object+----Glib::InitiallyUnowned+----Gtk2::Object+----Gtk2::Widget+----Gtk2::Container+----Gtk2::Bin+----Gtk2::Window+----Gtk2::Dialog+----Gtk2::MessageDialog
Interfaces
Glib::Object::_Unregistered::AtkImplementorIfaceGtk2::Buildable
Methods
widget = Gtk2::MessageDialog->new ($parent, $flags, $type, $buttons, $format, ...)
•
|
|
|---|---|
•
|
|
•
|
|
•
|
|
•
|
|
•
|
... (list) |
widget = Gtk2::MessageDialog->new_with_markup ($parent, $flags, $type, $buttons, $message)
•
|
|
|---|---|
•
|
|
•
|
|
•
|
|
•
|
|
Like "new", but allowing Pango markup tags in the message. Note that this version is not variadic.
Since: gtk+ 2.4
$message_dialog->format_secondary_markup ($message_format, ...)
•
|
|
|---|---|
•
|
... (list) |
Since: gtk+ 2.6
$message_dialog->format_secondary_text ($message_format, ...)
•
|
|
|---|---|
•
|
... (list) |
Since: gtk+ 2.6
widget = $dialog->get_image
Since: gtk+ 2.14
$dialog->set_image ($image)
- •
-
$image(Gtk2::Widget)
Since: gtk+ 2.10
$message_dialog->set_markup ($str)
- •
-
$str(string)
Since: gtk+ 2.4
widget = $message_dialog->get_message_area
Since: gtk+ 2.22
Properties
'buttons' (Gtk2::ButtonsType : default "none" : writable / construct-only / private)
|
The buttons shown in the message dialog |
|---|---|
'image' (Gtk2::Widget : default undef : readable / writable / private)
|
The image |
'message-area' (Gtk2::Widget : default undef : readable / private)
|
GtkVBox that holds the dialog's primary and secondary labels |
'message-type' (Gtk2::MessageType : default "info" : readable / writable / construct / private)
|
The type of message |
'secondary-text' (string : default undef : readable / writable / private)
|
The secondary text of the message dialog |
'secondary-use-markup' (boolean : default false : readable / writable / private)
|
The secondary text includes Pango markup. |
'text' (string : default "" : readable / writable / private)
|
The primary text of the message dialog |
'use-markup' (boolean : default false : readable / writable / private)
|
The primary text of the title includes Pango markup. |
Style properties
'message-border' (integer : default 12 : readable / private)
|
Width of border around the label and image in the message dialog |
|---|---|
'use-separator' (boolean : default false : readable / private)
|
Whether to put a separator between the message dialog's text and the buttons |
Enums and flags
enum Gtk2::ButtonsType
•
|
'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' |
flags Gtk2::DialogFlags
•
|
'modal' / 'GTK_DIALOG_MODAL' |
|---|---|
•
|
'destroy-with-parent' / 'GTK_DIALOG_DESTROY_WITH_PARENT' |
•
|
'no-separator' / 'GTK_DIALOG_NO_SEPARATOR' |
enum Gtk2::MessageType
•
|
'info' / 'GTK_MESSAGE_INFO' |
|---|---|
•
|
'warning' / 'GTK_MESSAGE_WARNING' |
•
|
'question' / 'GTK_MESSAGE_QUESTION' |
•
|
'error' / 'GTK_MESSAGE_ERROR' |
•
|
'other' / 'GTK_MESSAGE_OTHER' |
Releases
7 releases since Debian 3.1 (Sarge); the text changed 6 times.