gtk_elementComboBox

gtk_elementComboBox — Defines a specialised GtkComboBox to choose VisuElement.

Synopsis

                    VisuUiElementCombobox;
                    VisuUiElementComboboxClass;
GList *             visu_ui_element_combobox_getSelection
                                                        (VisuUiElementCombobox *wd);
GtkWidget *         visu_ui_element_combobox_new        (gboolean hasAllSelector,
                                                         gboolean hasNoneSelector,
                                                         const gchar *format);
gboolean            visu_ui_element_combobox_setSelection
                                                        (VisuUiElementCombobox *wd,
                                                         const gchar *name);
void                visu_ui_element_combobox_setUnphysicalStatus
                                                        (VisuUiElementCombobox *wd,
                                                         gboolean status);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkComboBox
                                 +----VisuUiElementCombobox

Implemented Interfaces

VisuUiElementCombobox implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.

Signals

  "element-selected"                               : Action

Description

This widget looks like a GtkComboBox and it displays a list of VisuElement currently used by the displayed data.

Details

VisuUiElementCombobox

typedef struct _VisuUiElementCombobox VisuUiElementCombobox;

An opaque structure defining a VisuUiElementCombobox widget.

Since 3.6


VisuUiElementComboboxClass

typedef struct _VisuUiElementComboboxClass VisuUiElementComboboxClass;

An opaque structure defining the class of a VisuUiElementCombobox widget.

Since 3.6


visu_ui_element_combobox_getSelection ()

GList *             visu_ui_element_combobox_getSelection
                                                        (VisuUiElementCombobox *wd);

Provide a list of selected elements.

wd :

a VisuUiElementCombobox widget.

Returns :

a newly created list of VisuElement. It should be freed later with g_list_free(). [transfer container][element-type VisuElement*]

Since 3.6


visu_ui_element_combobox_new ()

GtkWidget *         visu_ui_element_combobox_new        (gboolean hasAllSelector,
                                                         gboolean hasNoneSelector,
                                                         const gchar *format);

Creates a GtkComboBox with a list of available VisuElement. This list can contain in addition a "all" value if hasAllSelector is TRUE, or a "None" value if hasNoneSelector is TRUE. The format parameter is used to specify the text for each row of the GtkComboBox. If formt is NULL, just the name of the element is printed.

hasAllSelector :

a boolean.

hasNoneSelector :

a boolean.

format :

a string (can be NULL). [allow-none]

Returns :

a newly created widget. [transfer full]

Since 3.6


visu_ui_element_combobox_setSelection ()

gboolean            visu_ui_element_combobox_setSelection
                                                        (VisuUiElementCombobox *wd,
                                                         const gchar *name);

Select a VisuElement by providing its name.

wd :

a VisuUiElementCombobox widget.

name :

a string.

Returns :

TRUE if the given element exists.

Since 3.6


visu_ui_element_combobox_setUnphysicalStatus ()

void                visu_ui_element_combobox_setUnphysicalStatus
                                                        (VisuUiElementCombobox *wd,
                                                         gboolean status);

If status is TRUE, the combobox will also show elements that are tagged unphysical, see visu_element_getPhysical().

wd :

a VisuUiElementCombobox object ;

status :

a boolean

Since 3.7

Signal Details

The "element-selected" signal

void                user_function                      (VisuUiElementCombobox *combo,
                                                        gpointer               element,
                                                        gpointer               user_data)      : Action

This signal is emitted when a new element is selected.

combo :

the VisuUiElementCombobox that emits the signal ;

element :

the newly selected VisuElement.

user_data :

user data set when the signal handler was connected.

Since 3.6