## panelBrowser

panelBrowser

## Synopsis

    ToolPanel*          panelBrowser_init                   ();
    #define             BROWSER_PREVIOUS
    #define             BROWSER_NEXT
    gboolean            panelBrowserGet_currentSelected     (GtkTreePath **path,
                                                             GtkTreeIter *iterSelected);
    gboolean            panelBrowserGet_nextSelected        (GtkTreePath **path,
                                                             GtkTreeIter *iterSelected,
                                                             int direction);
    void                panelBrowserSet_currentDirectories  (gchar **dirs);
    void                panelBrowserSet_currentDirectory    (const gchar *dir);

## Description

## Details

### panelBrowser_init ()

    ToolPanel*          panelBrowser_init                   ();

Should be used in the list declared in externalModules.h to be loaded by V_Sim on start-up. This routine will create the ToolPanel handling the browser.

Returns : | a newly created ToolPanel object.

### BROWSER_PREVIOUS

    #define BROWSER_PREVIOUS 0

Value that give the direction when the selector is moved around file list. See `panelBrowserGet_nextSelected()`.

### BROWSER_NEXT

    #define BROWSER_NEXT     1

Value that give the direction when the selector is moved around file list. See `panelBrowserGet_nextSelected()`.

### panelBrowserGet_currentSelected ()

    gboolean            panelBrowserGet_currentSelected     (GtkTreePath **path,
                                                             GtkTreeIter *iterSelected);

Get iter and path of the currently sleected file.

`path` : | a pointer to returned the path of the currently selected file ;
`iterSelected` : | a pointer to store the currently selected iter.
Returns : | TRUE if one exists.

### panelBrowserGet_nextSelected ()

    gboolean            panelBrowserGet_nextSelected        (GtkTreePath **path,
                                                             GtkTreeIter *iterSelected,
                                                             int direction);

Change the selected file in the browser given the direction.

`path` : | a pointer to returned the path of the newly selected file ;
`iterSelected` : | a pointer to store the newly selected iter ;
`direction` : | BROWSER_NEXT or BROWSER_PREVIOUS.
Returns : | TRUE if one exists.

### panelBrowserSet_currentDirectories ()

    void                panelBrowserSet_currentDirectories  (gchar **dirs);

Change the directories for the browser. It is the same routine than `panelBrowserSet_currentDirectory()`, but several directories can be loaded at once. But internally, contrary to `panelBrowserSet_currentDirectory()` the given array must not be freed since it is not copied.

`dirs` : | a NULL terminated array of directories to be loaded.

### panelBrowserSet_currentDirectory ()

    void                panelBrowserSet_currentDirectory    (const gchar *dir);

Change the directory for the browser. The directory is not parsed immediately but only when the subpanel becomes visible.

`dir` : | the path of a directory.