## panelDataFile

panelDataFile — The tab where to configure the action of an external data file on colourisation of nodes.

## Synopsis

    ToolPanel*          panelDataFileInit                   ();
    gboolean            panelDataFileLoad_file              (VisuData *visuData,
                                                             const gchar *file,
                                                             gboolean *new);
    void                panelDataFileSet_use                (gboolean used);
    gboolean            panelDataFileSet_presetShade        (Shade *shade);
    void                panelDataFileUpdate                 (VisuData *visuData);

## Description

## Details

### panelDataFileInit ()

    ToolPanel*          panelDataFileInit                   ();

### panelDataFileLoad_file ()

    gboolean            panelDataFileLoad_file              (VisuData *visuData,
                                                             const gchar *file,
                                                             gboolean *new);

Read the given data file and associate the values of each column to the node. It does not update the widgets of the panel. This is done to allow to change the values of the colouration before drawing the widgets. See `panelDataFileUpdate()` to do it.

`visuData` : | the VisuData object to associated the data to ;
`file` : | the file to read ;
`new` : | return TRUE if the loaded data are associated for the first time to `visuData`.
Returns : | TRUE if `visu_data_createAllNodes()` should be called after.

### panelDataFileSet_use ()

    void                panelDataFileSet_use                (gboolean used);

Set if the panel is used or not.

`used` : | a boolean.

### panelDataFileSet_presetShade ()

    gboolean            panelDataFileSet_presetShade        (Shade *shade);

Change the preset `shade` used to colourise the data.

`shade` : | a Shade object.
Returns : | TRUE if a Shade is set.

### panelDataFileUpdate ()

    void                panelDataFileUpdate                 (VisuData *visuData);

Update the widgets depending on the colouration associated to the given VisuData object.

`visuData` : | the VisuData object to associated the data to.