Gtk2::MessageDialog

NAME

Gtk2::MessageDialog − wrapper for GtkMessageDialog

SYNOPSIS

#
# 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;

DESCRIPTION

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::AtkImplementorIface
Gtk2::Buildable

METHODS

widget = Gtk2::MessageDialog−>new ($parent, $flags, $type, $buttons, $format, ...)

$parent (Gtk2::Window or undef)

$flags (Gtk2::DialogFlags)

$type (Gtk2::MessageType)

$buttons (Gtk2::ButtonsType)

$format (scalar)

... (list)

widget = Gtk2::MessageDialog−>new_with_markup ($parent, $flags, $type, $buttons, $message)

$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

$message_dialog−>format_secondary_markup ($message_format, ...)

$message_format (scalar)

... (list)

Since: gtk+ 2.6

$message_dialog−>format_secondary_text ($message_format, ...)

$message_format (scalar)

... (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

SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::Window, Gtk2::Dialog

COPYRIGHT

Copyright (C) 2003−2011 by the gtk2−perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.