
The GtkDirSelect widget is derivated from GtkHBox.

Its purpose is to let the user choose a directory.

It basically looks like this:

  Label:_____________ [ ... ]

Of course, the label before the Entry can be changed by the programer.

When the user click on the ... button, a GtkFileSelector appears where
only the directory part is shown. When the user clicks on 'OK', the
Entry is updated and the "dir_changed" signal is emited.

Functions:
----------

The GtkDirSelect widgets are created with this function:
GtkWidget *gtk_dir_select_new(gchar *label,
                              gchar *directory,
                              gchar *FStitle);

  where 'label' is the text that will be displayed before the Entry,
        'directory' is the default directory (i.e. the one who's first
        displayed in the entry.
        'FStitle' is the title of the GtkFileSelector window.

You can set/get the current directory with these two accessor functions:
void gtk_dir_select_set_dir(GtkDirSelect *dirselect, gchar *newdir);
gchar *gtk_dir_select_get_dir(GtkDirSelect *dir_select);

Signals:
--------

  GtkDirSelects introduce a new signal: "dir_changed". This signal is
trigerred when the user press the "OK" button in the GtkFileSelector.
Callbacks associated with this signal should have the following
prototype:
void CallBack(GtkDirSelect *dir_select, gchar *new_dir, gpointer data);
where 'new_dir' is the newly selected directory.

Args:
-----
  GtkDirSelectes introduce 3 new Args, all of them are read/write:
  
  "GtkDirSelect::label" (GTK_TYPE_STRING) is the label displayed before the
                                          entry.
  "GtkDirSelect::directory" (GTK_TYPE_STRING) is the current directory.
  "GtkDirSelect::FS_title" (GTK_TYPE_STRING) is the title of the 
                                             GtkFileSelector Window.
      
Fields:
-------

You can access these read only fields of GtkDirSelect:
  GtkWidget *label;
  GtkWidget *entry;
  GtkWidget *button;

  guchar *FStitle;

They should be self-explanatory.

