Gtk2::Ex::Dialogs::ChooseDirectory is a Perl module that provides a file selection dialog.
use Gtk2::Ex::Dialogs::ChooseDirectory ( 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::ChooseDirectory::parent_window = $window;
# now popup a new dialog for selecting an existing directory
my $dir = select Gtk2::Ex::Dialogs::ChooseDirectory ( "/path/to/somewhere" );
# ok, now we need to create a new directory (doesn't actually make
# the directory), returns a dir that does not exist.
my $dir = create Gtk2::Ex::Dialogs::ChooseDirectory ( "/path/to/somewhere" );
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 "Select" or "Create" 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.