## gtk_pick

gtk_pick — The pick and measurement tab in the interactive dialog.

## Synopsis

    GtkWidget*          gtkPickBuild_interface              (VisuUiMain *main,
                                                             gchar **label,
                                                             gchar **help,
                                                             GtkWidget **radio);
    void                gtkPickStart                        (VisuRenderingWindow *window);
    void                gtkPickStop                         (VisuRenderingWindow *window);
    GList*              gtkPickGet_nodeSelection            ();
    void                gtkPick_onClose                     ();
    gboolean            gtkPickParse_XMLFile                (const gchar *filename,
                                                             VisuData *data,
                                                             GError **error);
    void                initGtkPick                         ();

## Description

## Details

### gtkPickBuild_interface ()

    GtkWidget*          gtkPickBuild_interface              (VisuUiMain *main,
                                                             gchar **label,
                                                             gchar **help,
                                                             GtkWidget **radio);

This routine should be called in conjonction to the `create_observeDialog()` one. It completes the creation of widgets (and also initialisation of values) for the pick tab.

`main` : | the main interface.
`label` : | a location to store the name of the pick tab ;
`help` : | a location to store the help message to be shown at the bottom of the window ;
`radio` : | a location on the radio button that will be toggled when the pick action is used.

### gtkPickStart ()

    void                gtkPickStart                        (VisuRenderingWindow *window);

Initialise a pick session.

`window` : | a VisuRenderingWindow object.

### gtkPickStop ()

    void                gtkPickStop                         (VisuRenderingWindow *window);

Finalise a pick session.

`window` : | a VisuRenderingWindow object.

### gtkPickGet_nodeSelection ()

    GList*              gtkPickGet_nodeSelection            ();

Compute a list of VisuNode currently listed.

Returns : | a newly created list. Should be freed with `g_list_free()` after use.

### gtkPick_onClose ()

    void                gtkPick_onClose                     ();

A routine to be called when the interactive window is closed. It currently cleans the labels for the pick information.

### gtkPickParse_XMLFile ()

    gboolean            gtkPickParse_XMLFile                (const gchar *filename,
                                                             VisuData *data,
                                                             GError **error);

Parse the given V_Sim value file and update the dialog accordingly.

`filename` : | a filename ;
`data` : | a VisuData object to take the pick information from ;
`error` : | a location to store possible errors.
Returns : | TRUE if no error.

### initGtkPick ()

    void                initGtkPick                         ();

Internal routine to setup the pick action of the interactive dialog.

Since 3.6