CSS nodes

HdyComboRow has a main CSS node with name row.

Its popover has the node name popover with the .combo style class, it contains a GtkScrolledWindow, which in turn contains a GtkListBox, both are accessible via their regular nodes.

A checkmark of node and style class image.checkmark in the popover denotes the current item.

HdyComboRowGetNameFunc ()

gchar *
(*HdyComboRowGetNameFunc) (gpointer item,
                           gpointer user_data);

Called for combo rows that are bound to a GListModel with hdy_combo_row_bind_name_model() for each item that gets added to the model.

HdyComboRowGetEnumValueNameFunc ()

gchar *
(*HdyComboRowGetEnumValueNameFunc) (HdyEnumValueObject *value,
                                    gpointer user_data);

Called for combo rows that are bound to an enumeration with hdy_combo_row_set_for_enum() for each value from that enumeration.

hdy_combo_row_new ()

GtkWidget *
hdy_combo_row_new (void);

Creates a new HdyComboRow.

Since: 0.0.6

hdy_combo_row_get_model ()

GListModel *
hdy_combo_row_get_model (HdyComboRow *self);

Gets the model bound to self , or NULL if none is bound.

Since: 0.0.6

hdy_combo_row_bind_model ()

void
hdy_combo_row_bind_model (HdyComboRow *self,
                          GListModel *model,
                          GtkListBoxCreateWidgetFunc create_list_widget_func,
                          GtkListBoxCreateWidgetFunc create_current_widget_func,
                          gpointer user_data,
                          GDestroyNotify user_data_free_func);

Binds model to self .

If self was already bound to a model, that previous binding is destroyed.

The contents of self are cleared and then filled with widgets that represent items from model . self is updated whenever model changes. If model is NULL, self is left empty.

Since: 0.0.6

hdy_combo_row_bind_name_model ()

void
hdy_combo_row_bind_name_model (HdyComboRow *self,
                               GListModel *model,
                               HdyComboRowGetNameFunc get_name_func,
                               gpointer user_data,
                               GDestroyNotify user_data_free_func);

Binds model to self .

If self was already bound to a model, that previous binding is destroyed.

The contents of self are cleared and then filled with widgets that represent items from model . self is updated whenever model changes. If model is NULL, self is left empty.

This is more conventient to use than hdy_combo_row_bind_model() if you want to represent items of the model with names.

Since: 0.0.6

hdy_combo_row_set_for_enum ()

void
hdy_combo_row_set_for_enum (HdyComboRow *self,
                            GType enum_type,
                            HdyComboRowGetEnumValueNameFunc get_name_func,
                            gpointer user_data,
                            GDestroyNotify user_data_free_func);

Creates a model for enum_type and binds it to self . The items of the model will be HdyEnumValueObject objects.

If self was already bound to a model, that previous binding is destroyed.

The contents of self are cleared and then filled with widgets that represent items from model . self is updated whenever model changes. If model is NULL, self is left empty.

This is more conventient to use than hdy_combo_row_bind_name_model() if you want to represent values of an enumeration with names.

See hdy_enum_value_row_name().

Since: 0.0.6

hdy_combo_row_get_selected_index ()

gint
hdy_combo_row_get_selected_index (HdyComboRow *self);

Gets the index of the selected item in its GListModel.

Since: 0.0.7

hdy_combo_row_set_selected_index ()

void
hdy_combo_row_set_selected_index (HdyComboRow *self,
                                  gint selected_index);

Sets the index of the selected item in its GListModel.

Since: 0.0.7

hdy_combo_row_get_use_subtitle ()

gboolean
hdy_combo_row_get_use_subtitle (HdyComboRow *self);

Gets whether the current value of self should be displayed as its subtitle.

Since: 0.0.10

hdy_combo_row_set_use_subtitle ()

void
hdy_combo_row_set_use_subtitle (HdyComboRow *self,
                                gboolean use_subtitle);

Sets whether the current value of self should be displayed as its subtitle.

If TRUE, you should not access HdyActionRow:subtitle.

Since: 0.0.10

hdy_combo_row_set_get_name_func ()

void
hdy_combo_row_set_get_name_func (HdyComboRow *self,
                                 HdyComboRowGetNameFunc get_name_func,
                                 gpointer user_data,
                                 GDestroyNotify user_data_free_func);

Sets a closure to convert items into names. See HdyComboRow:use-subtitle.

Since: 0.0.10

hdy_enum_value_row_name ()

gchar *
hdy_enum_value_row_name (HdyEnumValueObject *value,
                         gpointer user_data);

This is a default implementation of HdyComboRowGetEnumValueNameFunc to be used with hdy_combo_row_set_for_enum(). If the enumeration has a nickname, it will return it, otherwise it will return its name.

Since: 0.0.6

HDY_TYPE_COMBO_ROW

#define HDY_TYPE_COMBO_ROW (hdy_combo_row_get_type())

struct HdyComboRowClass

struct HdyComboRowClass {
  HdyActionRowClass parent_class;
};

HdyComboRow

typedef struct _HdyComboRow HdyComboRow;

The “selected-index” property

  “selected-index”           gint

The index of the selected item in its GListModel.

Flags: Read / Write

Allowed values: >= -1

Default value: -1

Since: 0.0.7

The “use-subtitle” property

  “use-subtitle”             gboolean

TRUE to set the current value as the subtitle.

If you use a custom widget creation function, you will need to give self a name conversion closure with hdy_combo_row_set_get_name_func().

If TRUE, you should not access HdyActionRow:subtitle.

Flags: Read / Write

Default value: FALSE

Since: 0.0.10