1Gtk2::Ex::Dialogs::ChooUsseeDrirCeocnttorriyb(u3t)ed PerGltkD2o:c:uEmxe:n:tDaitailoongs::ChooseDirectory(3)
2
3
4

NAME

6       Gtk2::Ex::Dialogs::ChooseDirectory - Provides a file selection dialog.
7

SYNOPSIS

9        use Gtk2::Ex::Dialogs::ChooseDirectory ( destroy_with_parent => TRUE,
10                                                 modal => TRUE );
11
12        # do some stuff like creating your app's main $window then,
13        # to ensure that all messages use the right parent, set it:
14        $Gtk2::Ex::Dialogs::ChooseDirectory::parent_window = $window;
15
16        # now popup a new dialog for selecting an existing directory
17        my $dir = select Gtk2::Ex::Dialogs::ChooseDirectory ( "/path/to/somewhere" );
18
19        # ok, now we need to create a new directory (doesn't actually make
20        # the directory), returns a dir that does not exist.
21        my $dir = create Gtk2::Ex::Dialogs::ChooseDirectory ( "/path/to/somewhere" );
22

DESCRIPTION

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

OPTIONS

29       All public methods (and the entire class) support the following
30       options:
31
32       title => STRING
33           The text string to use as the title of the dialog window. Defaults
34           to either "Select" or "Create" based on the action context.
35
36       path => STRING
37           The path to a file or directory to initialize the dialog with.
38           Defaults to the current working directory.
39
40       parent_window => Gtk2::Window
41           Reference to the main application window.
42
43       destroy_with_parent => BOOL
44           When the parent_window is destroyed, what do we do? Defaults to
45           FALSE.
46
47       modal => BOOL
48           Does this dialog make the parent_window freeze while the dialog
49           exists.  Defaults to FALSE.
50
51       must_exist => BOOL
52           The end-user must supply a path to an existing file or directory.
53           Should the end-user provide a non-existant path, the dialog will be
54           respawned until an existing file is chosen. Defaults to FALSE.
55

PUBLIC METHODS

57       OBJECT = new ( OPTIONS | PATH )
58           Create a Gtk2::FileChooserDialog with the options given and show it
59           to the end-user. Once the user has selected a directory return only
60           the path to the directoy and clean up. In the special case of being
61           passed only one argument, all options are set to defaults and the
62           one argument is used as the path argument.
63
64       RESPONSE = ask_to_select ( OPTIONS | PATH )
65           Supports all the same arguments as new(). This will create a new
66           Gtk2::Ex::Dialogs::ChooseDirectory, with some specific defaults,
67           and return the user's response. In the event of being given only
68           one argument, it will be used as the path option.
69
70       RESPONSE = ask_to_create ( OPTIONS | PATH )
71           Supports all the same arguments as new(). This will create a new
72           Gtk2::Ex::Dialogs::ChooseDirectory, with some specific defaults,
73           and return the user's response. In the event of being given only
74           one argument, it will be used as the path option.
75

SEE ALSO

77        Gtk2::FileChooser
78        Gtk2::FileChooserDialog
79        Gtk2::Ex::Dialogs
80        Gtk2::Ex::Dialogs::ChooseDirectory
81        Gtk2::Ex::Dialogs::ChooseFile
82        Gtk2::Ex::Dialogs::ChoosePreviewFile
83        Gtk2::Ex::Dialogs::ErrorMsg
84        Gtk2::Ex::Dialogs::Message
85        Gtk2::Ex::Dialogs::Question
86

BUGS

88       Please report any bugs to the mailing list.
89

MAILING LIST

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

AUTHORS

95        Kevin C. Krinke, <kckrinke@opendoorsoftware.com>
96        James Greenhalgh, <jgreenhalgh@opendoorsoftware.com>
97
99        Gtk2::Ex::Dialogs::ChooseDirectory - Provides a directory selection dialog.
100        Copyright (C) 2005 Open Door Software Inc. <ods@opendoorsoftware.com>
101
102        This library is free software; you can redistribute it and/or
103        modify it under the terms of the GNU Lesser General Public
104        License as published by the Free Software Foundation; either
105        version 2.1 of the License, or (at your option) any later version.
106
107        This library is distributed in the hope that it will be useful,
108        but WITHOUT ANY WARRANTY; without even the implied warranty of
109        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
110        Lesser General Public License for more details.
111
112        You should have received a copy of the GNU Lesser General Public
113        License along with this library; if not, write to the Free Software
114        Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
115
116
117
118perl v5.28.1                      2006-01-G1t1k2::Ex::Dialogs::ChooseDirectory(3)
Impressum