GtkIconFileSel
3
GTKEXTRA Library

# GtkIconFileSel

A file selection dialog widget for GTK.

## Synopsis

    #include <gtkextra.h>

                        GtkIconFileSel;
    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);
    const gchar *       gtk_icon_file_selection_get_selection
                                                            (GtkIconFileSel *filesel);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----GtkIconFileSel

## Implemented Interfaces

GtkIconFileSel implements AtkImplementorIface and GtkBuildable.

## 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

### GtkIconFileSel

    typedef struct _GtkIconFileSel GtkIconFileSel;

### gtk_icon_file_selection_new ()

    GtkWidget*          gtk_icon_file_selection_new         (const gchar *title);

`title` :

Returns :

### gtk_icon_file_selection_construct ()

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

Sets the window title for GtkIconFileSelection widget.

`filesel` :

  the GtkIconFileSelection widget.

`title` :

  window title.

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

`filesel` :

  the GtkIconFileSelection widget.

`show` :

  TRUE(show) or FALSE(don't show).

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

`filesel` :

  the GtkIconFileSelection widget.

`path` :

  directory path.

Returns :

  TRUE or FALSE depending on success

### gtk_icon_file_selection_show_hidden ()

    void                gtk_icon_file_selection_show_hidden (GtkIconFileSel *filesel,
                                                             gboolean visible);

Set the visibility of hidden files.

`filesel` :

  the GtkIconFileSelection widget.

`visible` :

  TRUE(show hidden files) or FALSE(don't show hidden files).

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

`filesel` :

  the GtkIconFileSelection widget.

`filter` :

  filter to be applied on files.

### gtk_icon_file_selection_get_selection ()

    const gchar *       gtk_icon_file_selection_get_selection
                                                            (GtkIconFileSel *filesel);

Gets the current selection applied on GtkIconFileSelection.

`filesel` :

  the GtkIconFileSelection widget.

Returns :

  the current selection.