GwyDataChooserFilterFunc()

gboolean
(*GwyDataChooserFilterFunc) (GwyContainer *data,
                             gint id,
                             gpointer user_data);

The type of data chooser filter function.

gwy_data_chooser_new_channels()

GtkWidget *
gwy_data_chooser_new_channels (void);

Creates a data chooser for data channels.

gwy_data_chooser_new_volumes()

GtkWidget *
gwy_data_chooser_new_volumes (void);

Creates a data chooser for volume data.

gwy_data_chooser_new_graphs()

GtkWidget *
gwy_data_chooser_new_graphs (void);

Creates a data chooser for graphs.

gwy_data_chooser_new_xyzs()

GtkWidget *
gwy_data_chooser_new_xyzs (void);

Creates a data chooser for XYZ data.

gwy_data_chooser_new_curve_maps()

GtkWidget *
gwy_data_chooser_new_curve_maps (void);

Creates a data chooser for curve map data.

gwy_app_data_id_new()

GwyAppDataId *
gwy_app_data_id_new (gint datano,
                     gint id);

Creates a new data identifier on heap.

This is mostly useful for language bindings.

gwy_app_data_id_copy()

GwyAppDataId *
gwy_app_data_id_copy (GwyAppDataId *dataid);

Creates a copy of data identifier.

This is mostly useful for language bindings.

gwy_app_data_id_free()

void
gwy_app_data_id_free (GwyAppDataId *dataid);

Frees a data identifier.

This is mostly useful for language bindings.

gwy_data_chooser_set_active()

gboolean
gwy_data_chooser_set_active (GwyDataChooser *chooser,
                             GwyContainer *data,
                             gint id);

Selects a data in a data chooser.

gwy_data_chooser_get_active()

GwyContainer *
gwy_data_chooser_get_active (GwyDataChooser *chooser,
                             gint *id);

Gets the selected item in a data chooser.

gwy_data_chooser_set_active_id()

gboolean
gwy_data_chooser_set_active_id (GwyDataChooser *chooser,
                                const GwyAppDataId *id);

Selects a data in a data chooser using numerical identifiers.

Passing NULL as id is permitted as a request to select the ‘none’ item.

gwy_data_chooser_get_active_id()

gboolean
gwy_data_chooser_get_active_id (GwyDataChooser *chooser,
                                GwyAppDataId *id);

Gets the selected item in a data chooser as numerical identifiers.

gwy_data_chooser_set_filter()

void
gwy_data_chooser_set_filter (GwyDataChooser *chooser,
                             GwyDataChooserFilterFunc filter,
                             gpointer user_data,
                             GDestroyNotify destroy);

Sets the filter applied to a data chooser.

The display of an item corresponding to no data is controlled by gwy_data_chooser_set_none(), filter function is only called for real data.

Use gwy_data_chooser_refilter() to update the list if the filter depends on external state and that changes.

gwy_data_chooser_get_none()

const gchar *
gwy_data_chooser_get_none (GwyDataChooser *chooser);

Gets the label of the item corresponding to no data.

gwy_data_chooser_set_none()

void
gwy_data_chooser_set_none (GwyDataChooser *chooser,
                           const gchar *none);

Sets the label of the item corresponding to no data.

gwy_data_chooser_get_filter()

GtkTreeModel *
gwy_data_chooser_get_filter (GwyDataChooser *chooser);

Gets the tree model filter used in a data chooser.

In general, you should not access the filter directly. An exception being gtk_tree_model_filter_refilter() when the filtering functions given in gwy_data_chooser_set_filter() depends on external state and that state changes. However, gwy_data_chooser_refilter() is usually more useful.

gwy_data_chooser_refilter()

void
gwy_data_chooser_refilter (GwyDataChooser *chooser);

Reruns the filter function of a data chooser.

This function is useful when the filtering functions given in gwy_data_chooser_set_filter() depends on external state and that state changes.

If the currently selected item becomes filtered out the chooser selects the no-data item if enabled. If the no-data item is disabled but the list contains some items then an arbitrary item is selected. At present, this means the first item in the list.

GWY_APP_DATA_ID_NONE

#define GWY_APP_DATA_ID_NONE { 0, -1 }

Initialiser for GwyAppDataId that corresponds to no data.

The macro would be typically used in initialisation as

1

GwyAppDataId dataid = GWY_APP_DATA_ID_NONE;

GwyAppDataId

typedef struct {
    gint datano;
    gint id;
} GwyAppDataId;

Auxiliary structure representing one data item in an open file.

The data container number can be obtained with gwy_app_data_browser_get() and used to look up the container with gwy_app_data_browser_get_number().

GwyDataChooser

typedef struct _GwyDataChooser GwyDataChooser;

GwyDataChooserClass

typedef struct _GwyDataChooserClass GwyDataChooserClass;