PHP-GTK Manual - Widget for selecting a file or a directory.

GtkFileSelection

Widget for selecting a file or a directory.

Object Hierarchy

GtkObject
`-- GtkWidget
       `-- GtkContainer
              `-- GtkBin
                     `-- GtkWindow
                            `-- GtkFileSelection

Description

GtkFileSelection is used to retrieve files or directories requested by the end user. The widget contains a directory list and a file list which will correspond to the default directory, that is, either the current working directory or one determined using set_filename() .

The filesystem can be navigated using either the directory tree or the dropdown history menu. Alternatively it is possible to type the directory or file path into the selection_entry field, and also to use the TAB key to autocomplete either the directory name or file name entered in this way.

Constructor

GtkFileSelection ([string title ]);

-- Creates a new GtkFileSelection widget.

Methods

set_filename()
Sets the default path.
get_filename()
Returns the current selected path.
complete()
Matches a given pattern to a valid file name.
show_fileop_buttons()
Shows the file operation buttons.
hide_fileop_buttons()
Hides the file operation buttons.

Properties

dir_list:
Directory list.
file_list:
File list.
selection_entry:
Entry field.
selection_text:
Directory selection status.
main_vbox:
Main container.
ok_button:
Standard button.
cancel_button:
Standard button.
action_area:
Container for custom additions.