Adw.ComboRow
Description: Reference for Adw.ComboRow

### Class

# AdwComboRow

#### Description [src]

    class Adw.ComboRow : Adw.ActionRow {
      parent_instance: AdwActionRow
    }

A `GtkListBoxRow` 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.

`AdwComboRow` mirrors `GtkDropDown`, see that widget for details.

`AdwComboRow` is `GtkListBoxRow: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 `GtkScrolledWindow`, which in turn contains a `GtkListView`, both are accessible via their regular nodes.

## Accessibility

`AdwComboRow` uses the `GTK_ACCESSIBLE_ROLE_COMBO_BOX` role.

Available since: | 1.0

#### Hierarchy

#### Ancestors

- AdwActionRow
- AdwPreferencesRow
- GtkListBoxRow
- GtkWidget
- GInitiallyUnowned
- GObject

#### Implements

- GtkAccessible
- GtkActionable
- GtkBuildable
- GtkConstraintTarget

#### Constructors

###### adw_combo_row_new

Creates a new `AdwComboRow`.

Available since: 1.0

#### Instance methods

###### adw_combo_row_get_expression

Gets the expression used to obtain strings from items.

Available since: 1.0

###### adw_combo_row_get_factory

Gets the factory that’s currently used to populate list items.

Available since: 1.0

###### adw_combo_row_get_list_factory

Gets the factory that’s currently used to populate list items in the popup.

Available since: 1.0

###### adw_combo_row_get_model

Gets the model that provides the displayed items.

Available since: 1.0

###### adw_combo_row_get_selected

Gets the position of the selected item.

Available since: 1.0

###### adw_combo_row_get_selected_item

Gets the selected item.

Available since: 1.0

###### adw_combo_row_get_use_subtitle

Gets whether to use the current value as the subtitle.

Available since: 1.0

###### adw_combo_row_set_expression

Sets the expression used to obtain strings from items.

Available since: 1.0

###### adw_combo_row_set_factory

Sets the `GtkListItemFactory` to use for populating list items.

Available since: 1.0

###### adw_combo_row_set_list_factory

Sets the `GtkListItemFactory` to use for populating list items in the popup.

Available since: 1.0

###### adw_combo_row_set_model

Sets the `GListModel` to use.

Available since: 1.0

###### adw_combo_row_set_selected

Selects the item at the given position.

Available since: 1.0

###### adw_combo_row_set_use_subtitle

Sets whether to use the current value as the subtitle.

Available since: 1.0

##### Methods inherited from AdwActionRow (14)

###### adw_action_row_activate

Activates `self`.

Available since: 1.0

###### adw_action_row_add_prefix

Adds a prefix widget to `self`.

Available since: 1.0

###### adw_action_row_add_suffix

Adds a suffix widget to `self`.

Available since: 1.0

###### adw_action_row_get_activatable_widget

Gets the widget activated when `self` is activated.

Available since: 1.0

###### adw_action_row_get_icon_name

Gets the icon name for `self`.

Available since: 1.0

###### adw_action_row_get_subtitle

Gets the subtitle for `self`.

Available since: 1.0

###### adw_action_row_get_subtitle_lines

Gets the number of lines at the end of which the subtitle label will be ellipsized.

Available since: 1.0

###### adw_action_row_get_title_lines

Gets the number of lines at the end of which the title label will be ellipsized.

Available since: 1.0

###### adw_action_row_remove

Removes a child from `self`.

Available since: 1.0

###### adw_action_row_set_activatable_widget

Sets the widget to activate when `self` is activated.

Available since: 1.0

###### adw_action_row_set_icon_name

Sets the icon name for `self`.

Available since: 1.0

###### adw_action_row_set_subtitle

Sets the subtitle for `self`.

Available since: 1.0

###### adw_action_row_set_subtitle_lines

Sets the number of lines at the end of which the subtitle label will be ellipsized.

Available since: 1.0

###### adw_action_row_set_title_lines

Sets the number of lines at the end of which the title label will be ellipsized.

Available since: 1.0

##### Methods inherited from AdwPreferencesRow (6)

###### adw_preferences_row_get_title

Gets the title of the preference represented by `self`.

Available since: 1.0

###### adw_preferences_row_get_title_selectable

Gets whether the user can copy the title from the label.

Available since: 1.0

###### adw_preferences_row_get_use_underline

Gets whether an embedded underline in the title indicates a mnemonic.

Available since: 1.0

###### adw_preferences_row_set_title

Sets the title of the preference represented by `self`.

Available since: 1.0

###### adw_preferences_row_set_title_selectable

Sets whether the user can copy the title from the label.

Available since: 1.0

###### adw_preferences_row_set_use_underline

Sets whether an embedded underline in the title indicates a mnemonic.

Available since: 1.0

##### Methods inherited from GtkListBoxRow (11)

##### Methods inherited from GtkWidget (159)

##### Methods inherited from GObject (43)

#### Properties

###### Adw.ComboRow:expression

An expression used to obtain strings from items.

Available since: 1.0

###### Adw.ComboRow:factory

Factory for populating list items.

Available since: 1.0

###### Adw.ComboRow:list-factory

The factory for populating list items in the popup.

Available since: 1.0

###### Adw.ComboRow:model

Model for the displayed items.

Available since: 1.0

###### Adw.ComboRow:selected

The position of the selected item.

Available since: 1.0

###### Adw.ComboRow:selected-item

The selected item.

Available since: 1.0

###### Adw.ComboRow:use-subtitle

Whether to use the current value as the subtitle.

Available since: 1.0

##### Properties inherited from AdwActionRow (5)

###### Adw.ActionRow:activatable-widget

The widget to activate when the row is activated.

Available since: 1.0

###### Adw.ActionRow:icon-name

The icon name for this row.

Available since: 1.0

###### Adw.ActionRow:subtitle

The subtitle for this row.

Available since: 1.0

###### Adw.ActionRow:subtitle-lines

The number of lines at the end of which the subtitle label will be ellipsized.

Available since: 1.0

###### Adw.ActionRow:title-lines

The number of lines at the end of which the title label will be ellipsized.

Available since: 1.0

##### Properties inherited from AdwPreferencesRow (3)

###### Adw.PreferencesRow:title

The title of the preference represented by this row.

Available since: 1.0

###### Adw.PreferencesRow:title-selectable

Whether the user can copy the title from the label.

Available since: 1.0

###### Adw.PreferencesRow:use-underline

Whether an embedded underline in the title indicates a mnemonic.

Available since: 1.0

##### Properties inherited from GtkListBoxRow (3)

##### Properties inherited from GtkWidget (34)

#### Signals

##### Signals inherited from AdwActionRow (1)

###### Adw.ActionRow::activated

This signal is emitted after the row has been activated.

Available since: 1.0

##### Signals inherited from GtkListBoxRow (1)

##### Signals inherited from GtkWidget (13)

##### Signals inherited from GObject (1)

#### Class structure

    struct AdwComboRowClass {
      AdwActionRowClass parent_class;

    }

###### Class members

`parent_class` |
    AdwActionRowClass
| The parent class.