ComboRow

Object Hierarchy:

Description:

[ CCode ( type_id = "adw_combo_row_get_type ()" ) ]
public class ComboRow : ActionRow, Accessible, Actionable, Buildable, ConstraintTarget

A [class@Gtk.

ListBoxRow] used to choose from a list of items.

The `AdwComboRow` widget allows the user to choose from a list of valid choices. The row displays the selected choice. When activated, the row displays a popover which allows the user to make a new choice.

Example of an `AdwComboRow` UI definition: ```xml <object class="AdwComboRow"> <property name="title" translatable="yes">Combo Row </property> <property name="model"> <object class="GtkStringList"> <items> <item translatable="yes">Foo< /item> <item translatable="yes">Bar</item> <item translatable="yes">Baz</item> </items> </object> </property> </object> ```

The [property@ComboRow:selected] and [property@ComboRow:selected-item] properties can be used to keep track of the selected item and react to their changes.

`AdwComboRow` mirrors [class@Gtk.DropDown], see that widget for details.

`AdwComboRow` is [property@Gtk.ListBoxRow:activatable] if a model is set.

CSS nodes

`AdwComboRow` has a main CSS node with name `row` and the `.combo` style class.

Its popover has the node named `popover` with the `.menu` style class, it contains a [class@Gtk.ScrolledWindow], which in turn contains a [ class@Gtk.ListView], both are accessible via their regular nodes.

Accessibility

`AdwComboRow` uses the `GTK_ACCESSIBLE_ROLE_COMBO_BOX` role.

Namespace: Adw

Package: libadwaita-1

Content:

Properties:

public bool enable_search { get; set; }
Whether to show a search entry in the popup.
public Expression expression { get; set; }
An expression used to obtain strings from items.
public ListItemFactory factory { get; set; }
Factory for populating list items.
public ListItemFactory list_factory { get; set; }
The factory for populating list items in the popup.
public ListModel model { get; set; }
The model that provides the displayed items.
public uint selected { get; set; }
The position of the selected item.
public Object selected_item { get; }
The selected item.
public bool use_subtitle { get; set; }
Whether to use the current value as the subtitle.

Creation methods:

public ComboRow ()
Creates a new `AdwComboRow`.

Methods:

public bool get_enable_search ()
Gets whether search is enabled.
public unowned Expression? get_expression ()
Gets the expression used to obtain strings from items.
public unowned ListItemFactory? get_factory ()
Gets the factory for populating list items.
public unowned ListItemFactory? get_list_factory ()
Gets the factory for populating list items in the popup.
public unowned ListModel? get_model ()
Gets the model that provides the displayed items.
public uint get_selected ()
Gets the position of the selected item.
public unowned Object? get_selected_item ()
Gets the selected item.
public bool get_use_subtitle ()
Gets whether to use the current value as the subtitle.
public void set_enable_search (bool enable_search)
Sets whether to enable search.
public void set_expression (Expression? expression)
Sets the expression used to obtain strings from items.
public void set_factory (ListItemFactory? factory)
Sets the factory for populating list items.
public void set_list_factory (ListItemFactory? factory)
Sets the factory for populating list items in the popup.
public void set_model (ListModel? model)
Sets the model that provides the displayed items.
public void set_selected (uint position)
Selects the item at the given position.
public void set_use_subtitle (bool use_subtitle)
Sets whether to use the current value as the subtitle.

Inherited Members:

All known members inherited from class Adw.ActionRow

All known members inherited from class Adw.PreferencesRow

All known members inherited from class Gtk.ListBoxRow

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Actionable

All known members inherited from interface Gtk.Buildable