Gtk2::FileChooser(3) User Contributed Perl Documentation Gtk2::FileChooser(3) NAME Gtk2::FileChooser - wrapper for GtkFileChooser HIERARCHY Glib::Interface +----Gtk2::FileChooser METHODS filechooseraction = $chooser->get_action $chooser->set_action ($action) o $action (Gtk2::FileChooserAction) $chooser->add_filter ($filter) o $filter (Gtk2::FileFilter) $chooser->add_shortcut_folder ($folder) o $folder (string) $chooser->add_shortcut_folder_uri ($folder) o $folder (string) boolean = $chooser->get_create_folders Since: gtk+ 2.18 $chooser->set_create_folders ($create_folders) o $create_folders (boolean) Since: gtk+ 2.18 string = $chooser->get_current_folder boolean = $chooser->set_current_folder ($filename) o $filename (string) string = $chooser->get_current_folder_uri boolean = $chooser->set_current_folder_uri ($uri) o $uri (string) $chooser->set_current_name ($name) o $name (string) boolean = $chooser->get_do_overwrite_confirmation Since: gtk+ 2.8 $chooser->set_do_overwrite_confirmation ($do_overwrite_confirmation) o $do_overwrite_confirmation (boolean) Since: gtk+ 2.8 widget = $chooser->get_extra_widget $chooser->set_extra_widget ($extra_widget) o $extra_widget (Gtk2::Widget) string = $chooser->get_filename boolean = $chooser->set_filename ($filename) o $filename (string) list = $chooser->get_filenames filefilter = $chooser->get_filter $chooser->set_filter ($filter) o $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) o $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) o $active (boolean) widget = $chooser->get_preview_widget $chooser->set_preview_widget ($preview_widget) o $preview_widget (Gtk2::Widget) $chooser->remove_filter ($filter) o $filter (Gtk2::FileFilter) $chooser->remove_shortcut_folder ($folder) o $folder (string) $chooser->remove_shortcut_folder_uri ($folder) o $folder (string) $chooser->select_all boolean = $chooser->select_filename ($filename) o $filename (string) boolean = $chooser->get_select_multiple $chooser->set_select_multiple ($select_multiple) o $select_multiple (boolean) boolean = $chooser->select_uri ($uri) o $uri (string) boolean = $chooser->get_show_hidden Since: gtk+ 2.6 $chooser->set_show_hidden ($show_hidden) o $show_hidden (boolean) Since: gtk+ 2.6 $chooser->unselect_all $chooser->unselect_filename ($filename) o $filename (string) $chooser->unselect_uri ($uri) o $uri (string) string = $chooser->get_uri boolean = $chooser->set_uri ($uri) o $uri (string) list = $chooser->get_uris boolean = $chooser->get_use_preview_label $chooser->set_use_preview_label ($use_label) o $use_label (boolean) PROPERTIES 'action' (Gtk2::FileChooserAction : default "open" : readable / writable / private / static-nick / static-blurb) The type of operation that the file selector is performing 'create-folders' (boolean : default true : readable / writable / private / static-nick / static-blurb) 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 / static-nick / static-blurb) Whether a file chooser in save mode will present an overwrite confirmation dialog if necessary. 'extra-widget' (Gtk2::Widget : default undef : readable / writable / private / static-nick / static-blurb) Application supplied widget for extra options. 'file-system-backend' (string : default undef : writable / construct-only / private / static-nick / static-blurb) Name of file system backend to use 'filter' (Gtk2::FileFilter : default undef : readable / writable / private / static-nick / static-blurb) The current filter for selecting which files are displayed 'local-only' (boolean : default true : readable / writable / private / static-nick / static-blurb) Whether the selected file(s) should be limited to local file: URLs 'preview-widget' (Gtk2::Widget : default undef : readable / writable / private / static-nick / static-blurb) Application supplied widget for custom previews. 'preview-widget-active' (boolean : default true : readable / writable / private / static-nick / static-blurb) Whether the application supplied widget for custom previews should be shown. 'select-multiple' (boolean : default false : readable / writable / private / static-nick / static-blurb) Whether to allow multiple files to be selected 'show-hidden' (boolean : default false : readable / writable / private / static-nick / static-blurb) Whether the hidden files and folders should be displayed 'use-preview-label' (boolean : default true : readable / writable / private / static-nick / static-blurb) 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 o 'open' / 'GTK_FILE_CHOOSER_ACTION_OPEN' o 'save' / 'GTK_FILE_CHOOSER_ACTION_SAVE' o 'select-folder' / 'GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER' o 'create-folder' / 'GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER' enum Gtk2::FileChooserConfirmation o 'confirm' / 'GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM' o 'accept-filename' / 'GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME' o 'select-again' / 'GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN' enum Gtk2::FileChooserError o 'nonexistent' / 'GTK_FILE_CHOOSER_ERROR_NONEXISTENT' o 'bad-filename' / 'GTK_FILE_CHOOSER_ERROR_BAD_FILENAME' o 'already-exists' / 'GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS' o '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. perl v5.38.0 2023-07-25 Gtk2::FileChooser(3)