GtkFileSelection

Prompts the user for a file/directory name.

Object Hierarchy

  GObject
  GtkObject
  GtkWidget
  GtkContainer
  GtkBin
  GtkWindow
  GtkDialog
  GtkFileSelection

Description

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 names.

The GtkFileSelection is actually made of the following GtkWidget fields:

• fileop_dialog: This dialog box is used to display the GtkFileSelection. You may customize it using the standard GtkDialog functions.
• 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 GtkFileSelection widget.
• 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.

Fields

action_area:

 

button_area:

 

cancel_button:

  Refers to the cancel button of the file selection prompt.

dir_list:

  Refers to the directory list displayed on the left of the file selection prompt.

file_list:

  Refers to the file list displayed on the right of the file selection prompt.

fileop_c_dir:

  Refers to the create directory operation button of the dialog.

fileop_del_file:

  Refers to the delete file operation button of the dialog.

fileop_dialog:

  Refers to the dialog that contains the operation buttons.

fileop_entry:

 

fileop_file:

 

fileop_ren_file:

  Refers to the rename file operation button of the dialog.

help_button:

  Refers to the help button of the file selection prompt.

history_menu:

 

history_pulldown:

 

main_vbox:

 

ok_button:

  Refers to the OK button of the file selection prompt.

selection_entry:

 

selection_text: