1Gtk2::MessageDialog(3)User Contributed Perl DocumentationGtk2::MessageDialog(3)
2
6 Gtk2::MessageDialog - wrapper for GtkMessageDialog
7
9 #
10 # A modal dialog. Note that the message is a printf-style format.
11 #
12 $dialog = Gtk2::MessageDialog->new ($main_application_window,
13 'destroy-with-parent',
14 'question', # message type
15 'yes-no', # which set of buttons?
16 "Pay me $%.2f?", $amount);
17 $response = $dialog->run;
18 if ($response eq 'yes') {
19 send_bill ();
20 }
21 $dialog->destroy;
22 #
24 # A non-modal dialog.
25 #
26 $dialog = Gtk2::MessageDialog->new ($main_application_window,
27 'destroy-with-parent',
28 'question', # message type
29 'ok-cancel', # which set of buttons?
30 "Self-destruct now?");
31 # react whenever the user responds.
32 $dialog->signal_connect (response => sub {
33 my ($self, $response) = @_;
34 if ($response eq 'ok') {
35 do_the_thing ();
36 }
37 $self->destroy;
38 });
39 $dialog->show_all;
40
42 Gtk2::MessageDialog is a dialog with an image representing the type of
43 message (Error, Question, etc.) alongside some message text. It's
44 simply a convenience widget; you could construct the equivalent of
45 Gtk2::MessageDialog from Gtk2::Dialog without too much effort, but
46 Gtk2::MessageDialog saves typing and helps create a consistent look and
47 feel for your application.
48 The easiest way to do a modal message dialog is to use "$dialog->run",
50 which automatically makes your dialog modal and waits for the user to
51 respond to it. You can also pass in the GTK_DIALOG_MODAL flag when
52 creating the MessageDialog.
53
55 Glib::Object
56 +----Glib::InitiallyUnowned
57 +----Gtk2::Object
58 +----Gtk2::Widget
59 +----Gtk2::Container
60 +----Gtk2::Bin
61 +----Gtk2::Window
62 +----Gtk2::Dialog
63 +----Gtk2::MessageDialog
64
66 Glib::Object::_Unregistered::AtkImplementorIface
67 Gtk2::Buildable
68
70 widget = Gtk2::MessageDialog->new ($parent, $flags, $type, $buttons,
71 $format, ...)
72 • $parent (Gtk2::Window or undef)
73 • $flags (Gtk2::DialogFlags)
75 • $type (Gtk2::MessageType)
77 • $buttons (Gtk2::ButtonsType)
79 • $format (scalar)
81 • ... (list)
83 widget = Gtk2::MessageDialog->new_with_markup ($parent, $flags, $type,
85 $buttons, $message)
86 • $parent (Gtk2::Window or undef)
87 • $flags (Gtk2::DialogFlags)
89 • $type (Gtk2::MessageType)
91 • $buttons (Gtk2::ButtonsType)
93 • $message (string or undef) a string containing Pango markup
95 Like "new", but allowing Pango markup tags in the message. Note that
97 this version is not variadic.
98 Since: gtk+ 2.4
100 $message_dialog->format_secondary_markup ($message_format, ...)
102 • $message_format (scalar)
103 • ... (list)
105 Since: gtk+ 2.6
107 $message_dialog->format_secondary_text ($message_format, ...)
109 • $message_format (scalar)
110 • ... (list)
112 Since: gtk+ 2.6
114 widget = $dialog->get_image
116 Since: gtk+ 2.14
117 $dialog->set_image ($image)
119 • $image (Gtk2::Widget)
120 Since: gtk+ 2.10
122 $message_dialog->set_markup ($str)
124 • $str (string)
125 Since: gtk+ 2.4
127 widget = $message_dialog->get_message_area
129 Since: gtk+ 2.22
130
132 'buttons' (Gtk2::ButtonsType : default "none" : writable / construct-
133 only / private / static-nick / static-blurb)
134 The buttons shown in the message dialog
135 'image' (Gtk2::Widget : default undef : readable / writable / private /
137 static-nick / static-blurb)
138 The image
139 'message-area' (Gtk2::Widget : default undef : readable / private /
141 static-nick / static-blurb)
142 GtkVBox that holds the dialog's primary and secondary labels
143 'message-type' (Gtk2::MessageType : default "info" : readable /
145 writable / construct / private / static-nick / static-blurb)
146 The type of message
147 'secondary-text' (string : default undef : readable / writable /
149 private / static-nick / static-blurb)
150 The secondary text of the message dialog
151 'secondary-use-markup' (boolean : default false : readable / writable /
153 private / static-nick / static-blurb)
154 The secondary text includes Pango markup.
155 'text' (string : default "" : readable / writable / private / static-
157 nick / static-blurb)
158 The primary text of the message dialog
159 'use-markup' (boolean : default false : readable / writable / private /
161 static-nick / static-blurb)
162 The primary text of the title includes Pango markup.
163
165 'message-border' (integer : default 12 : readable / private / static-
166 nick / static-blurb)
167 Width of border around the label and image in the message dialog
168 'use-separator' (boolean : default false : readable / private / static-
170 nick / static-blurb)
171 Whether to put a separator between the message dialog's text and
172 the buttons
173
175 enum Gtk2::ButtonsType
176 • 'none' / 'GTK_BUTTONS_NONE'
177 • 'ok' / 'GTK_BUTTONS_OK'
179 • 'close' / 'GTK_BUTTONS_CLOSE'
181 • 'cancel' / 'GTK_BUTTONS_CANCEL'
183 • 'yes-no' / 'GTK_BUTTONS_YES_NO'
185 • 'ok-cancel' / 'GTK_BUTTONS_OK_CANCEL'
187 flags Gtk2::DialogFlags
189 • 'modal' / 'GTK_DIALOG_MODAL'
190 • 'destroy-with-parent' / 'GTK_DIALOG_DESTROY_WITH_PARENT'
192 • 'no-separator' / 'GTK_DIALOG_NO_SEPARATOR'
194 enum Gtk2::MessageType
196 • 'info' / 'GTK_MESSAGE_INFO'
197 • 'warning' / 'GTK_MESSAGE_WARNING'
199 • 'question' / 'GTK_MESSAGE_QUESTION'
201 • 'error' / 'GTK_MESSAGE_ERROR'
203 • 'other' / 'GTK_MESSAGE_OTHER'
205
207 Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget,
208 Gtk2::Container, Gtk2::Bin, Gtk2::Window, Gtk2::Dialog
209
211 Copyright (C) 2003-2011 by the gtk2-perl team.
212 This software is licensed under the LGPL. See Gtk2 for a full notice.
214perl v5.36.0 2023-01-20 Gtk2::MessageDialog(3)