Provided by: libgtk2-perl-doc_1.249-2_all bug

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

       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.