Prompts the user for a file/directory name.
This widget is particularly useful when you want to retrieve a file or
directory name from the user. It is slightly more advanced than the
file selector in two ways: firstly, the user may select a directory
here, and secondly, you have the choice to let the user create
You may create a new GtkFileSelection by using
its constructor. This will generate a dialog box containing a directory
list, and a file list corresponding to the current working directory.
The file system may be navigated using the directory list or the
drop-down history menu (the visibility of which may be controlled).
Note that the TAB key may also be used for completing file/directory
is actually made of the
fileop_dialog: This dialog box is used to display the
GtkFileSelection. You may customize it using the standard
ok_button, cancel_button: These two buttons should be connected
appropriately to handle situations when the user clicks the OK or
Cancel buttons respectively in the
history_pulldown: This is effectively a
GtkOptionMenu that may be used to control the
drop-down history of directories.
fileop_c_dir, fileop_del_file, fileop_ren_file: These are the operation
buttons that appear at the top of the
GtkFileSelection and perform the operations of
creating a directory, deleting a file and renaming a file
respectively. You may use the hide_fileop_buttons() and show_fileop_buttons() methods
to control their visibility.
Refers to the cancel button of the file selection prompt.
Refers to the directory list displayed on the left of the file
Refers to the file list displayed on the right of the file selection
Refers to the create directory operation button of the dialog.
Refers to the delete file operation button of the dialog.
Refers to the dialog that contains the operation buttons.
Refers to the rename file operation button of the dialog.
Refers to the help button of the file selection prompt.
Refers to the OK button of the file selection prompt.