gtk_file_selection_new ()

GtkWidget *
gtk_file_selection_new (const gchar *title);

gtk_file_selection_complete ()

void
gtk_file_selection_complete (GtkFileSelection *filesel,
                             const gchar *pattern);

gtk_file_selection_show_fileop_buttons ()

void
gtk_file_selection_show_fileop_buttons
                               (GtkFileSelection *filesel);

gtk_file_selection_hide_fileop_buttons ()

void
gtk_file_selection_hide_fileop_buttons
                               (GtkFileSelection *filesel);

gtk_file_selection_set_select_multiple ()

void
gtk_file_selection_set_select_multiple
                               (GtkFileSelection *filesel,
                                gboolean select_multiple);

Sets whether the user is allowed to select multiple files in the file list. Use gtk_file_selection_get_selections() to get the list of selected files.

gtk_file_selection_get_select_multiple ()

gboolean
gtk_file_selection_get_select_multiple
                               (GtkFileSelection *filesel);

Determines whether or not the user is allowed to select multiple files in the file list. See gtk_file_selection_set_select_multiple().

struct GtkFileSelection

struct GtkFileSelection {
  GtkWidget *dir_list;
  GtkWidget *file_list;
  GtkWidget *selection_entry;
  GtkWidget *selection_text;
  GtkWidget *main_vbox;
  GtkWidget *ok_button;
  GtkWidget *cancel_button;
  GtkWidget *help_button;
  GtkWidget *history_pulldown;
  GtkWidget *history_menu;
  GList     *history_list;
  GtkWidget *fileop_dialog;
  GtkWidget *fileop_entry;
  gchar     *fileop_file;
  gpointer   cmpl_state;

  GtkWidget *fileop_c_dir;
  GtkWidget *fileop_del_file;
  GtkWidget *fileop_ren_file;

  GtkWidget *button_area;
  GtkWidget *action_area;
};

gtk_file_selection_set_filename

#define gtk_file_selection_set_filename gtk_file_selection_set_filename_utf8

Sets a default path for the file requestor. If filename includes a directory path, then the requestor will open with that path as its current working directory.

This has the consequence that in order to open the requestor with a working directory and an empty filename, filename must have a trailing directory separator.

The encoding of filename is preferred GLib file name encoding, which may not be UTF-8. See g_filename_from_utf8().

gtk_file_selection_get_filename

#define gtk_file_selection_get_filename gtk_file_selection_get_filename_utf8

This function returns the selected filename in the GLib file name encoding. To convert to UTF-8, call g_filename_to_utf8(). The returned string points to a statically allocated buffer and should be copied if you plan to keep it around.

If no file is selected then the selected directory path is returned.

gtk_file_selection_get_selections

#define gtk_file_selection_get_selections gtk_file_selection_get_selections_utf8

Retrieves the list of file selections the user has made in the dialog box. This function is intended for use when the user can select multiple files in the file list.

The filenames are in the GLib file name encoding. To convert to UTF-8, call g_filename_to_utf8() on each string.

The “filename” property

  “filename”                 char *

The currently selected filename.

Owner: GtkFileSelection

Flags: Read / Write

Default value: NULL

The “select-multiple” property

  “select-multiple”          gboolean

Whether to allow multiple files to be selected.

Owner: GtkFileSelection

Flags: Read / Write

Default value: FALSE

The “show-fileops” property

  “show-fileops”             gboolean

Whether buttons for creating/manipulating files should be displayed.

Owner: GtkFileSelection

Flags: Read / Write

Default value: TRUE