Gtk2::FileChooser(3)

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.