ListBase#

class ListBase(**properties: Any)#

Superclasses: Widget, InitiallyUnowned, Object

Subclasses: GridView, ListView

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, Orientable, Scrollable

GtkListBase is the abstract base class for GTK’s list widgets.

Shortcuts and Gestures#

GtkListBase supports the following keyboard shortcuts:

  • Ctrl+:kbd:A or Ctrl+<kbd>wzxhzdk:0</kbd> selects all items.

  • Ctrl+:kbd:Shift+:kbd:A or Ctrl+<kbd>wzxhzdk:1</kbd> unselects all items.

The focused item is controlled by the navigation keys below, combined with the Ctrl modifier to prevent moving the selection, and the Shift modifier to extend the current selection.

  • ←, →, ↑, ↓ move the focus on the next item in the designed direction.

  • Home and End focus the first or last item.

  • PgUp and PgDn move the focus one page up or down.

List item widgets support the following keyboard shortcuts:

  • Enter activates the item.

  • <kbd>␣</kbd> selects the item, with the same Ctrl and Shift modifiers combinations as the navigation keys.

Actions#

GtkListBase defines a set of built-in actions:

  • list.scroll-to-item moves the visible area to the item at given position with the minimum amount of scrolling required. If the item is already visible, nothing happens.

  • list.select-item changes the selection.

  • list.select-all selects all items in the model, if the selection model supports it.

  • list.unselect-all unselects all items in the model, if the selection model supports it.

List item widgets install the following actions:

  • listitem.select changes selection if the item is selectable.

  • listitem.scroll-to moves the visible area of the list to this item with the minimum amount of scrolling required.

Properties#

class ListBase
props.orientation: Orientation#

The type of the None singleton.