Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Gtk2::Ex::Dialogs(3)  User Contributed Perl Documentation Gtk2::Ex::Dialogs(3)

NAME
       Gtk2::Ex::Dialogs - Useful tools	for Gnome2/Gtk2	Perl GUI design.

SYNOPSIS
	use Gtk2::Ex::Dialogs (	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->set_parent_window( $window );

	# now popup a new dialog
	my $r =	ask Gtk2::Ex::Dialogs::Question	( "Is Perl only	hacker's glue?"	);
	if ( $r	) {
	  # end-user thinks so
	} else {
	  # end-user does not think so
	}

	# 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 new dialog ( blocking the	main loop if there is one )
	new_and_run
	 Gtk2::Ex::Dialogs::ErrorMsg ( "Simple error message." );

DESCRIPTION
       This module provides the	Gtk2::Ex::Dialogs::Message,
       Gtk2::Ex::Dialogs::ErrorMsg and Gtk2::Ex::Dialogs::Question classes to
       the main	application while setting the initial defaults to those
       specified upon using Gtk2::Ex::Dialogs.

OPTIONS
       Gtk2::Ex::Dialogs supports the following	options:

       title =>	STRING
	   The title of	the dialog window. Defaults to an empty	string.

       text => STRING
	   The text to be displayed. This is the core purpose of the module
	   and is the only mandatory argument.

       icon => /path/to/image || stock-id || Gtk2::Gdk::Pixbuf || Gtk2::Image
	   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 the stock-id "gtk-dialog-question".

       parent_window =>	Gtk2::Window
	   Reference to	the main application window.

       destroy_with_parent => BOOL
	   When	the parent_window is destroyed,	what do	we do? Defaults	to
	   FALSE.

       modal =>	BOOL
	   Does	this message make the parent_window freeze while the message
	   exists.  Defaults to	FALSE.

       no_separator => BOOL
	   Draw	the horizontal separator between the content area and the
	   button area below. Defaults to FALSE.

       default_yes => BOOL
	   Autofocus on	the "YES" button. Defaults to FALSE.

       must_exist => BOOL
	   The end-user	must supply a path to an existing file or directory.
	   Should the end-user provide a non-existant path, the	dialog will be
	   respawned until an existing file is chosen. Defaults	to FALSE.

FUNCTIONS
       This module provides a "set_" function for all options that takes a
       signle argument that is then used as the	default	for all	three modules
       Gtk2::Ex::Dialogs::Message, Gtk2::Ex::Dialogs::ErrorMsg and
       Gtk2::Ex::Dialogs::Question. For	clarity, the function names are	as
       follows:

       Gtk2::Ex::Dialogs->set_title
       Gtk2::Ex::Dialogs->set_text
       Gtk2::Ex::Dialogs->set_icon
       Gtk2::Ex::Dialogs->set_modal
       Gtk2::Ex::Dialogs->set_parent_window
       Gtk2::Ex::Dialogs->set_destroy_with_parent
       Gtk2::Ex::Dialogs->set_default_yes
       Gtk2::Ex::Dialogs->set_must_exist

SEE ALSO
	Gtk2::Dialog
	Gtk2::MessageDialog
	Gtk2::Ex::Dialogs::ChooseDirectory
	Gtk2::Ex::Dialogs::ChooseFile
	Gtk2::Ex::Dialogs::ChoosePreviewFile
	Gtk2::Ex::Dialogs::Message
	Gtk2::Ex::Dialogs::ErrorMsg
	Gtk2::Ex::Dialogs::Question

BUGS
       Please report any bugs to the mailing list.

MAILING	LIST
	http://odsgnulinux.com/lists/gtk2-ex-list
	gtk2-ex-list@odsgnulinux.com

AUTHORS
	Kevin C. Krinke, <kckrinke@opendoorsoftware.com>
	James Greenhalgh, <jgreenhalgh@opendoorsoftware.com>

COPYRIGHT AND LICENSE
	Gtk2::Ex::Dialogs - Useful tools for Gnome2/Gtk2 Perl GUI design.
	Copyright (C) 2005 Open	Door Software Inc. <ods@opendoorsoftware.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

perl v5.24.1			  2006-01-11		  Gtk2::Ex::Dialogs(3)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FUNCTIONS | SEE ALSO | BUGS | MAILING LIST | AUTHORS | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Gtk2::Ex::Dialogs&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help