NAME¶
Gtk2::FileChooser - wrapper for GtkFileChooser
HIERARCHY¶
Glib::Interface
+----Gtk2::FileChooser
METHODS¶
filechooseraction = $chooser->get_action¶
$chooser->set_action ($action)¶
- •
- $action (Gtk2::FileChooserAction)
$chooser->add_filter ($filter)¶
- •
- $filter (Gtk2::FileFilter)
$chooser->add_shortcut_folder ($folder)¶
- •
- $folder (string)
$chooser->add_shortcut_folder_uri ($folder)¶
- •
- $folder (string)
boolean = $chooser->get_create_folders¶
Since: gtk+ 2.18
$chooser->set_create_folders ($create_folders)¶
- •
- $create_folders (boolean)
Since: gtk+ 2.18
string = $chooser->get_current_folder¶
boolean = $chooser->set_current_folder ($filename)¶
- •
- $filename (string)
string = $chooser->get_current_folder_uri¶
boolean = $chooser->set_current_folder_uri ($uri)¶
- •
- $uri (string)
$chooser->set_current_name ($name)¶
- •
- $name (string)
boolean = $chooser->get_do_overwrite_confirmation¶
Since: gtk+ 2.8
$chooser->set_do_overwrite_confirmation
($do_overwrite_confirmation)¶
- •
- $do_overwrite_confirmation (boolean)
Since: gtk+ 2.8
- •
- $extra_widget (Gtk2::Widget)
string = $chooser->get_filename¶
boolean = $chooser->set_filename ($filename)¶
- •
- $filename (string)
list = $chooser->get_filenames¶
filefilter = $chooser->get_filter¶
$chooser->set_filter ($filter)¶
- •
- $filter (Gtk2::FileFilter)
list = $chooser->list_filters¶
list = $chooser->list_shortcut_folder_uris¶
list = $chooser->list_shortcut_folders¶
boolean = $chooser->get_local_only¶
$chooser->set_local_only ($files_only)¶
- •
- $files_only (boolean)
localized file name =
$file_chooser->get_preview_filename¶
string = $file_chooser->get_preview_uri¶
- •
- $active (boolean)
- •
- $preview_widget (Gtk2::Widget)
$chooser->remove_filter ($filter)¶
- •
- $filter (Gtk2::FileFilter)
$chooser->remove_shortcut_folder ($folder)¶
- •
- $folder (string)
$chooser->remove_shortcut_folder_uri ($folder)¶
- •
- $folder (string)
$chooser->select_all¶
boolean = $chooser->select_filename ($filename)¶
- •
- $filename (string)
boolean = $chooser->get_select_multiple¶
$chooser->set_select_multiple ($select_multiple)¶
- •
- $select_multiple (boolean)
boolean = $chooser->select_uri ($uri)¶
- •
- $uri (string)
boolean = $chooser->get_show_hidden¶
Since: gtk+ 2.6
$chooser->set_show_hidden ($show_hidden)¶
- •
- $show_hidden (boolean)
Since: gtk+ 2.6
$chooser->unselect_all¶
$chooser->unselect_filename ($filename)¶
- •
- $filename (string)
$chooser->unselect_uri ($uri)¶
- •
- $uri (string)
string = $chooser->get_uri¶
boolean = $chooser->set_uri ($uri)¶
- •
- $uri (string)
list = $chooser->get_uris¶
boolean = $chooser->get_use_preview_label¶
$chooser->set_use_preview_label ($use_label)¶
- •
- $use_label (boolean)
PROPERTIES¶
- 'action' (Gtk2::FileChooserAction : default
"open" : readable / writable / private)
- The type of operation that the file selector is
performing
- 'create-folders' (boolean : default true : readable /
writable / private)
- Whether a file chooser not in open mode will offer the user
to create new folders.
- 'do-overwrite-confirmation' (boolean : default false :
readable / writable / private)
- Whether a file chooser in save mode will present an
overwrite confirmation dialog if necessary.
- 'extra-widget' (Gtk2::Widget : default undef : readable /
writable / private)
- Application supplied widget for extra options.
- 'file-system-backend' (string : default undef : writable /
construct-only / private)
- Name of file system backend to use
- 'filter' (Gtk2::FileFilter : default undef : readable /
writable / private)
- The current filter for selecting which files are
displayed
- 'local-only' (boolean : default true : readable / writable
/ private)
- Whether the selected file(s) should be limited to local
file: URLs
- 'preview-widget' (Gtk2::Widget : default undef : readable /
writable / private)
- Application supplied widget for custom previews.
- 'preview-widget-active' (boolean : default true : readable
/ writable / private)
- Whether the application supplied widget for custom previews
should be shown.
- 'select-multiple' (boolean : default false : readable /
writable / private)
- Whether to allow multiple files to be selected
- 'show-hidden' (boolean : default false : readable /
writable / private)
- Whether the hidden files and folders should be
displayed
- 'use-preview-label' (boolean : default true : readable /
writable / private)
- Whether to display a stock label with the name of the
previewed file.
SIGNALS¶
- selection-changed (Gtk2::FileChooser)
- current-folder-changed (Gtk2::FileChooser)
- update-preview (Gtk2::FileChooser)
- file-activated (Gtk2::FileChooser)
- Gtk2::FileChooserConfirmation = confirm-overwrite
(Gtk2::FileChooser)
ENUMS AND FLAGS¶
enum Gtk2::FileChooserAction¶
- •
- 'open' / 'GTK_FILE_CHOOSER_ACTION_OPEN'
- •
- 'save' / 'GTK_FILE_CHOOSER_ACTION_SAVE'
- •
- 'select-folder' /
'GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER'
- •
- 'create-folder' /
'GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER'
enum Gtk2::FileChooserConfirmation¶
- •
- 'confirm' / 'GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM'
- •
- 'accept-filename' /
'GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME'
- •
- 'select-again' /
'GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN'
enum Gtk2::FileChooserError¶
- •
- 'nonexistent' / 'GTK_FILE_CHOOSER_ERROR_NONEXISTENT'
- •
- 'bad-filename' / 'GTK_FILE_CHOOSER_ERROR_BAD_FILENAME'
- •
- 'already-exists' /
'GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS'
- •
- 'incomplete-hostname' /
'GTK_FILE_CHOOSER_ERROR_INCOMPLETE_HOSTNAME'
SEE ALSO¶
Gtk2, Glib::Interface
COPYRIGHT¶
Copyright (C) 2003-2011 by the gtk2-perl team.
This software is licensed under the LGPL. See Gtk2 for a full notice.