adw.combo_row

Module for ComboRow class

class ComboRow ComboRowGidBuilder ComboRowGidBuilderImpl

Types 3

classComboRow : adw.action_row.ActionRow

A gtk.list_box_row.ListBoxRow used to choose from a list of items.

combo-row

The adw.combo_row.ComboRow 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 adw.combo_row.ComboRow UI definition:

<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 adw.combo_row.ComboRow.selected and adw.combo_row.ComboRow.selectedItem properties can be used to keep track of the selected item and react to their changes.

adw.combo_row.ComboRow mirrors gtk.drop_down.DropDown, see that widget for details.

adw.combo_row.ComboRow is gtk.list_box_row.ListBoxRow.activatable if a model is set.

CSS nodes

adw.combo_row.ComboRow 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 gtk.scrolled_window.ScrolledWindow, which in turn contains a gtk.list_view.ListView, both are accessible via their regular nodes.

Accessibility

adw.combo_row.ComboRow uses the gtk.types.AccessibleRole.ComboBox role.

Methods

GType _getGType()

GType _gType() @property

ComboRow self()Returns `this`, for use in `with` statements.

ComboRowGidBuilder builder()Get builder for [adw.combo_row.ComboRow] Returns: New builder object

bool enableSearch() @propertyGet `enableSearch` property. Returns: Whether to show a search entry in the popup.

void enableSearch(bool propval) @propertySet `enableSearch` property. Params: propval = Whether to show a search entry in the popup.

gtk.expression.Expression expression() @propertyGet `expression` property. Returns: An expression used to obtain strings from items.

void expression(gtk.expression.Expression propval) @propertySet `expression` property. Params: propval = An expression used to obtain strings from items.

gtk.list_item_factory.ListItemFactory factory() @propertyGet `factory` property. Returns: Factory for populating list items.

void factory(gtk.list_item_factory.ListItemFactory propval) @propertySet `factory` property. Params: propval = Factory for populating list items.

gtk.list_item_factory.ListItemFactory listFactory() @propertyGet `listFactory` property. Returns: The factory for populating list items in the popup.

void listFactory(gtk.list_item_factory.ListItemFactory propval) @propertySet `listFactory` property. Params: propval = The factory for populating list items in the popup.

gio.list_model.ListModel model() @propertyGet `model` property. Returns: The model that provides the displayed items.

void model(gio.list_model.ListModel propval) @propertySet `model` property. Params: propval = The model that provides the displayed items.

uint selected() @propertyGet `selected` property. Returns: The position of the selected item.

void selected(uint propval) @propertySet `selected` property. Params: propval = The position of the selected item.

gobject.object.ObjectWrap selectedItem() @propertyGet `selectedItem` property. Returns: The selected item.

bool useSubtitle() @propertyGet `useSubtitle` property. Returns: Whether to use the current value as the subtitle.

void useSubtitle(bool propval) @propertySet `useSubtitle` property. Params: propval = Whether to use the current value as the subtitle.

bool getEnableSearch()Gets whether search is enabled.

gtk.expression.Expression getExpression()Gets the expression used to obtain strings from items. Returns: the expression used to obtain strings from items

gtk.list_item_factory.ListItemFactory getFactory()Gets the factory for populating list items. Returns: the factory in use

gtk.list_item_factory.ListItemFactory getListFactory()Gets the factory for populating list items in the popup. Returns: the factory in use

gio.list_model.ListModel getModel()Gets the model that provides the displayed items. Returns: The model in use

uint getSelected()Gets the position of the selected item. Returns: the position of the selected item, or [gtk.types.INVALID_LIST_POSITION] if no item is selected

gobject.object.ObjectWrap getSelectedItem()Gets the selected item. Returns: the selected item

bool getUseSubtitle()Gets whether to use the current value as the subtitle. Returns: whether to use the current value as the subtitle

void setEnableSearch(bool enableSearch)Sets whether to enable search.

void setExpression(gtk.expression.Expression expression = null)Sets the expression used to obtain strings from items.

void setFactory(gtk.list_item_factory.ListItemFactory factory = null)Sets the factory for populating list items.

void setListFactory(gtk.list_item_factory.ListItemFactory factory = null)Sets the factory for populating list items in the popup.

void setModel(gio.list_model.ListModel model = null)Sets the model that provides the displayed items.

void setSelected(uint position)Selects the item at the given position.

void setUseSubtitle(bool useSubtitle)Sets whether to use the current value as the subtitle.

Constructors

this(void * ptr, Flag!"Take" take)

this()Creates a new [adw.combo_row.ComboRow]. Returns: the newly created [adw.combo_row.ComboRow]

classComboRowGidBuilderImpl(T) : adw.action_row.ActionRowGidBuilderImpl!T

Fluent builder implementation template for adw.combo_row.ComboRow

Methods

T enableSearch(bool propval)Set `enableSearch` property. Params: propval = Whether to show a search entry in the popup.

T expression(gtk.expression.Expression propval)Set `expression` property. Params: propval = An expression used to obtain strings from items.

T factory(gtk.list_item_factory.ListItemFactory propval)Set `factory` property. Params: propval = Factory for populating list items.

T listFactory(gtk.list_item_factory.ListItemFactory propval)Set `listFactory` property. Params: propval = The factory for populating list items in the popup.

T model(gio.list_model.ListModel propval)Set `model` property. Params: propval = The model that provides the displayed items. Returns: Builder instance for fluent chaining

T selected(uint propval)Set `selected` property. Params: propval = The position of the selected item.

T useSubtitle(bool propval)Set `useSubtitle` property. Params: propval = Whether to use the current value as the subtitle.

classComboRowGidBuilder : ComboRowGidBuilderImpl!ComboRowGidBuilder

Fluent builder for adw.combo_row.ComboRow

Methods

ComboRow build()Create object from builder. Returns: New object