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

FreeBSD Manual Pages

  
 
  

home | help
Gtk2::Ex::Dialogs::ChoUserrContributed)Gtk2::Ex::Dialogs::ChoosePreviewFile(3)

NAME
       Gtk2::Ex::Dialogs::ChoosePreviewFile - Provides a file selection
       dialog.

SYNOPSIS
	use Gtk2::Ex::Dialogs::ChoosePreviewFile ( destroy_with_parent => TRUE,
					    modal => TRUE );

	# 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::ChoosePreviewFile::parent_window = $window;

	# now popup a new dialog for opening a file
	my $file = ask_to_open
		    Gtk2::Ex::Dialogs::ChoosePreviewFile ( "/path/to/something"	);

	# ok, now we need to save (as...) a file
	my $save = ask_to_save
		    Gtk2::Ex::Dialogs::ChoosePreviewFile ( "/path/to/something"	);

DESCRIPTION
       This module provides a simple file chooser api that wraps
       Gtk2::FileChooser objectively. The objective is a simple	ways to	prompt
       a user to open or save a	file.

OPTIONS
       All public methods (and the entire class) support the following
       options:

       title =>	STRING
	   The text string to use as the title of the dialog window. Defaults
	   to either "Open" or "Save" based on the action context.

       path => STRING
	   The path to a file or directory to initialize the dialog with.
	   Defaults to the current working directory.

       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 dialog make the parent_window freeze while	the dialog
	   exists.  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.

PUBLIC METHODS
       OBJECT =	new ( OPTIONS |	PATH )
	   Create a Gtk2::FileChooserDialog with the options given and show it
	   to the end-user. Once the user has selected a file return only the
	   path	to the file and	clean up. In the special case of being passed
	   only	one argument, all options are set to defaults and the one
	   argument is used as the path	argument.

       RESPONSE	= ask_to_open (	OPTIONS	| PATH )
	   Supports all	the same arguments as new(). This will create a	new
	   Gtk2::Ex::Dialogs::ChoosePreviewFile, with some specific defaults,
	   and return the user's response. In the event	of being given only
	   one argument, it will be used as the	path option.

       RESPONSE	= ask_to_save (	OPTIONS	| PATH )
	   Supports all	the same arguments as new(). This will create a	new
	   Gtk2::Ex::Dialogs::ChoosePreviewFile, with some specific defaults,
	   and return the user's response. In the event	of being given only
	   one argument, it will be used as the	path option.

SEE ALSO
	Gtk2::FileChooser
	Gtk2::FileChooserDialog
	Gtk2::Ex::Dialogs
	Gtk2::Ex::Dialogs::ChooseDirectory
	Gtk2::Ex::Dialogs::ChooseFile
	Gtk2::Ex::Dialogs::ErrorMsg
	Gtk2::Ex::Dialogs::Message
	Gtk2::Ex::Dialogs::Question

BUGS
       Please report any bugs to the mailing list.

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

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

COPYRIGHT AND LICENSE
	Gtk2::Ex::Dialogs::ChoosePreviewFile - Provides	a file selection dialog.
	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-Gtk2::Ex::Dialogs::ChoosePreviewFile(3)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | PUBLIC METHODS | 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::ChoosePreviewFile&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help