Gtk2::Ex::Dialogs::Message - Provides a simple message dialog.
use Gtk2::Ex::Dialogs::Message ( destroy_with_parent => TRUE, modal => TRUE, no_separator => FALSE ); # do some stuff like creating your app's main $window then, # to ensure that all messages use the right parent, set it: $Gtk2::Ex::Dialogs::Message::parent_window = $window; # now popup a new dialog ( blocking the main loop if there is one ) new_and_run Gtk2::Ex::Dialogs::Message ( title => "Dialog Title", text => "This is a simple message" ); # now popup a somwhat useful dialog that doesn't block any main loop # but on the other side of the coin, if there is no main loop the # dialog will be completely unresponsive. new_show Gtk2::Ex::Dialogs::Message ( title => "Uhm", text => "Use when there is a main loop." );
This module provides a simple dialog api that wraps Gtk2::Dialog objectively. The objective is a clean and simple message dialog (only an "OK" button).
All public methods (and the entire class) support the following options:
The title of the dialog window. Defaults to an empty string.
The text to be displayed. This is the core purpose of the module and is the only mandatory argument.
The dialog-sized image to place to the left of the text. Note: there are five aliased stock-ids which correspond to the five gtk-dialog-* ids, "warning", "question", "info", "error" and "authentication". Defaults to no icon being created at all.
Reference to the main application window.
When the parent_window is destroyed, what do we do? Defaults to FALSE.
Does this message make the parent_window freeze while the message exists. Defaults to FALSE.
Draw the horizontal separator between the content area and the button area below. Defaults to FALSE.
Create a new Gtk2::Dialog with only an "OK" button, some text and an optional icon to the left of the text. The icon can be any of the following: a stock-id string, a Gtk2::Image, Gtk2::Gdk::Pixbuf or the full path to an image. Return a Gtk2::Ex::Dialogs::Message object. In the special case of being passed only one argument, all options are set to defaults and the one argument is used as the text option.
Supports all the same arguments as new(). This will create a new Gtk2::Ex::Dialogs::Message, show_all(), run() and then destroy the dialog immediately.
Supports all the same arguments as new(). This will create a new Gtk2::Ex::Dialogs::Message, show_all() and process any pending gtk events. This functionality is only of any practical use when there is a Gtk2 main loop running. If there is no main loop running the dialog will be visible but completely unresponsive to the end-user.
Gtk2::Dialog Gtk2::MessageDialog Gtk2::Ex::Dialogs Gtk2::Ex::Dialogs::ChooseDirectory Gtk2::Ex::Dialogs::ChooseFile Gtk2::Ex::Dialogs::ChoosePreviewFile Gtk2::Ex::Dialogs::ErrorMsg Gtk2::Ex::Dialogs::Message
Please report any bugs to the mailing list.
Kevin C. Krinke, <email@example.com> James Greenhalgh, <firstname.lastname@example.org>
Gtk2::Ex::Dialogs::Message - Provides a simple message dialog. Copyright (C) 2005 Open Door Software Inc. <email@example.com> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA