| GTK-EXTRA - Reference Manual

| Home

## Name

### Gtkiconfileselection - gtkiconfileselection dialog widget for gtk+

## Synopsis

    GtkType
    gtk_icon_file_selection_get_type
    (void);
    GtkWidget*
    gtk_icon_file_selection_new
    (const gchar *title);
    void
    gtk_icon_file_selection_construct
    (GtkIconFileSel *filesel,
    const gchar *title);
    void
    gtk_icon_file_selection_show_tree
    GtkIconFileSel *filesel,
    gboolean show);
    gint
    gtk_icon_file_selection_open_dir
    (GtkIconFileSel *filesel,
    const gchar *path);
    void
    gtk_icon_file_selection_show_hidden
    (GtkIconFileSel *filesel,
    gboolean visible);
    void
    gtk_icon_file_selection_set_filter
    (GtkIconFileSel *filesel,
    const gchar *filter);

## Object Hierarchy

##
Args

## Signal Prototypes

    No signals

## Description

####
It is a nice looking file selection dialog using icons.
It combines GtkDirTree and GtkFileList to navigate the file system and select files.
It has also two entries to select the file and filter.

##
Details

    struct _GtkIconFileSel
    {
      GtkWindow window;
      gchar *title;
      gboolean show_tree;
      GtkWidget *path_label;

      GtkWidget *tree_window;
      GtkWidget *dir_tree;
      GtkWidget *list_window;
      GtkWidget *file_list;
      GtkWidget *history_combo;
      guint tree_signal_id;
      GtkWidget *file_entry;
      GtkWidget *filter_entry;
      GtkWidget *ok_button;
      GtkWidget *cancel_button;
      GtkWidget *action_area;     /* It's a GtkTable with the entries */
    };

## Screenshot
This is the diference between GtkFilelist and Gtkiconfileselection

### gtk_icon_file_selection_get_type ()

    GtkType gtk_icon_file_selection_get_type (void);

##

### gtk_icon_file_selection_new ()

    GtkWidget* gtk_icon_file_selection_new (const gchar *title);

Create a new icon file selection widget

title | the title of the widget
Returns | the icon file selection widget

### gtk_icon_file_selection_construct ()

    void gtk_icon_file_selection_construct (GtkIconFileSel *filesel,
                                            const gchar *title);

Initialize the icon file selection structure.

file sel | the icon file selection widget
title | the title of the widget

### gtk_icon_file_selection_show_tree ()

    void gtk_icon_file_selection_show_tree (GtkIconFileSel *filesel,
                                            gboolean show);

Show icon file selection tree in filesel widget.

file sel | the icon file selection widget
`show` | TRUE or FALSE

### gtk_icon_file_selection_open_dir ()

    gint gtk_icon_file_selection_open_dir (GtkIconFileSel *filesel,
                                           const gchar *path);

Show the file from path directory in filesel widget

file sel | the icon file selection widget
path | the path of the directory

### gtk_icon_file_selection_show_hidden ()

    void gtk_icon_file_selection_show_hidden (GtkIconFileSel *filesel,
                                              gboolean visible);

file sel | the icon file selection widget
visible | TRUE or FALSE

### gtk_icon_file_selection_set_filter ()

    void gtk_icon_file_selection_set_filter (GtkIconFileSel *filesel,
                                            const gchar *filter);

Set a filter for the files show in filelist.

file sel | the icon file selection widget
filter | a filter string

| Home |  |