Gtk2::FileChooser

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

widget = $chooser−>get_extra_widget
$chooser−>set_extra_widget ($extra_widget)

$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
boolean = $chooser−>get_preview_widget_active
$chooser−>set_preview_widget_active ($active)

$active (boolean)

widget = $chooser−>get_preview_widget
$chooser−>set_preview_widget ($preview_widget)

$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

Gtk2::FileChooserConfirmation = confirm-overwrite (Gtk2::FileChooser)
current-folder-changed
(Gtk2::FileChooser)
file-activated
(Gtk2::FileChooser)
selection-changed
(Gtk2::FileChooser)
update-preview
(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.