GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Gtk2::Ex::Dialogs::ChoosePreviewFile(3) User Contributed Perl Documentation Gtk2::Ex::Dialogs::ChoosePreviewFile(3)

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

 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" );

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.

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.

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.

 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

Please report any bugs to the mailing list.

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

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

 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
2006-01-11 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.