Gtk2::FileChooser(3)					User Contributed Perl Documentation				      Gtk2::FileChooser(3)

NAME

       Gtk2::FileChooser

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)

   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 : readable / writable / private)
	   The type of operation that the file selector is performing

       'create-folders' (boolean : readable / writable / private)
	   Whether a file chooser not in open mode will offer the user to create new folders.

       'do-overwrite-confirmation' (boolean : readable / writable / private)
	   Whether a file chooser in save mode will present an overwrite confirmation dialog if necessary.

       'extra-widget' (Gtk2::Widget : readable / writable / private)
	   Application supplied widget for extra options.

       'file-system-backend' (string : writable / construct-only / private)
	   Name of file system backend to use

       'filter' (Gtk2::FileFilter : readable / writable / private)
	   The current filter for selecting which files are displayed

       'local-only' (boolean : readable / writable / private)
	   Whether the selected file(s) should be limited to local file: URLs

       'preview-widget' (Gtk2::Widget : readable / writable / private)
	   Application supplied widget for custom previews.

       'preview-widget-active' (boolean : readable / writable / private)
	   Whether the application supplied widget for custom previews should be shown.

       'select-multiple' (boolean : readable / writable / private)
	   Whether to allow multiple files to be selected

       'show-hidden' (boolean : readable / writable / private)
	   Whether the hidden files and folders should be displayed

       'use-preview-label' (boolean : 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)
       GtkFileChooserConfirmation = confirm-overwrite (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::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'

   enum GtkFileChooserConfirmation
       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'

SEE ALSO

       Gtk2, Glib::Interface

COPYRIGHT

       Copyright (C) 2003-2008 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gtk2 for a full notice.

perl v5.12.1							    2010-07-05						      Gtk2::FileChooser(3)