Package ch.bailu.gtk.adw

Klasse ComboRow

java.lang.Object
ch.bailu.gtk.type.Type
ch.bailu.gtk.type.Pointer
ch.bailu.gtk.gobject.Object
ch.bailu.gtk.type.PropertyHolder
ch.bailu.gtk.gobject.InitiallyUnowned
ch.bailu.gtk.gtk.Widget
ch.bailu.gtk.gtk.ListBoxRow
ch.bailu.gtk.adw.PreferencesRow
ch.bailu.gtk.adw.ActionRow
ch.bailu.gtk.adw.ComboRow
Alle implementierten Schnittstellen:
PointerInterface
public class ComboRow extends ActionRow
A [class@Gtk.ListBoxRow] used to choose from a list of items.

<picture>
<source srcset="combo-row-dark.png" media="(prefers-color-scheme: dark)">
<img src="combo-row.png" alt="combo-row">
</picture>

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.

https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.ComboRow.html

  • Konstruktordetails

    • ComboRow

      public ComboRow(PointerContainer pointer)

    • ComboRow

      public ComboRow()
      Creates a new `AdwComboRow`.

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • getEnableSearch

      public boolean getEnableSearch()
      Gets whether search is enabled.

      If set to `TRUE`, a search entry will be shown in the popup that
      allows to search for items in the list.

      Search requires [property@ComboRow:expression] to be set.
      Gibt zurück:
      whether the popup includes a search entry

    • getExpression

      public Expression getExpression()
      Gets the expression used to obtain strings from items.
      Gibt zurück:
      the expression used to obtain strings from items

    • getFactory

      public ListItemFactory getFactory()
      Gets the factory for populating list items.
      Gibt zurück:
      the factory in use

    • getHeaderFactory

      public ListItemFactory getHeaderFactory()
      Gets the factory that's currently used to create header widgets for the popup.
      Gibt zurück:
      The factory in use

    • getListFactory

      public ListItemFactory getListFactory()
      Gets the factory for populating list items in the popup.
      Gibt zurück:
      the factory in use

    • getModel

      public ListModel getModel()
      Gets the model that provides the displayed items.
      Gibt zurück:
      The model in use

    • getSearchMatchMode

      public int getSearchMatchMode()
      Returns the match mode that the search filter is using.
      Gibt zurück:
      the match mode of the search filter

    • getSelected

      public int getSelected()
      Gets the position of the selected item.
      Gibt zurück:
      the position of the selected item, or [const@Gtk.INVALID_LIST_POSITION] if no item is selected

    • getSelectedItem

      public Pointer getSelectedItem()
      Gets the selected item.
      Gibt zurück:
      the selected item

    • getUseSubtitle

      public boolean getUseSubtitle()
      Gets whether to use the current value as the subtitle.
      Gibt zurück:
      whether to use the current value as the subtitle

    • setEnableSearch

      public void setEnableSearch(boolean enable_search)
      Sets whether to enable search.

      If set to `TRUE`, a search entry will be shown in the popup that
      allows to search for items in the list.

      Search requires [property@ComboRow:expression] to be set.
      Parameter:
      enable_search - whether to enable search

    • setExpression

      public void setExpression(@Nullable Expression expression)
      Sets the expression used to obtain strings from items.

      The expression must have a value type of `G_TYPE_STRING`.

      It's used to bind strings to labels produced by the default factory if
      [property@ComboRow:factory] is not set, or when
      [property@ComboRow:use-subtitle] is set to `TRUE`.
      Parameter:
      expression - an expression

    • setFactory

      public void setFactory(@Nullable ListItemFactory factory)
      Sets the factory for populating list items.

      This factory is always used for the item in the row. It is also used for
      items in the popup unless [property@ComboRow:list-factory] is set.
      Parameter:
      factory - the factory to use

    • setHeaderFactory

      public void setHeaderFactory(@Nullable ListItemFactory factory)
      Sets the factory to use for creating header widgets for the popup.
      Parameter:
      factory - the factory to use

    • setListFactory

      public void setListFactory(@Nullable ListItemFactory factory)
      Sets the factory for populating list items in the popup.

      If this is not set, [property@ComboRow:factory] is used.
      Parameter:
      factory - the factory to use

    • setModel

      public void setModel(@Nullable ListModel model)
      Sets the model that provides the displayed items.
      Parameter:
      model - the model to use

    • setSearchMatchMode

      public void setSearchMatchMode(int search_match_mode)
      Sets the match mode for the search filter.
      Parameter:
      search_match_mode - the new match mode

    • setSelected

      public void setSelected(int position)
      Selects the item at the given position.
      Parameter:
      position - the position of the item to select, or [const@Gtk.INVALID_LIST_POSITION]

    • setUseSubtitle

      public void setUseSubtitle(boolean use_subtitle)
      Sets whether to use the current value as the subtitle.

      If you use a custom list item factory, you will need to give the row a
      name conversion expression with [property@ComboRow:expression].

      If set to `TRUE`, you should not access [property@ActionRow:subtitle].

      The subtitle is interpreted as Pango markup if
      [property@PreferencesRow:use-markup] is set to `TRUE`.
      Parameter:
      use_subtitle - whether to use the current value as the subtitle

    • asAccessible

      public Accessible asAccessible()
      Implements interface Accessible. Call this to get access to interface functions.
      Setzt außer Kraft:
      asAccessible in Klasse ActionRow
      Gibt zurück:
      Accessible

    • asActionable

      public Actionable asActionable()
      Implements interface Actionable. Call this to get access to interface functions.
      Setzt außer Kraft:
      asActionable in Klasse ActionRow
      Gibt zurück:
      Actionable

    • asBuildable

      public Buildable asBuildable()
      Implements interface Buildable. Call this to get access to interface functions.
      Setzt außer Kraft:
      asBuildable in Klasse ActionRow
      Gibt zurück:
      Buildable

    • asConstraintTarget

      public ConstraintTarget asConstraintTarget()
      Implements interface ConstraintTarget. Call this to get access to interface functions.
      Setzt außer Kraft:
      asConstraintTarget in Klasse ActionRow
      Gibt zurück:
      ConstraintTarget

    • getTypeID

      public static long getTypeID()

    • getParentTypeID

      public static long getParentTypeID()

    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()

    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()

    • getInstanceSize

      public static int getInstanceSize()