Object Hierarchy:

Object hierarchy for ListBox


[ CCode ( type_id = "gtk_list_box_get_type ()" ) ]
public class ListBox : Widget, Accessible, Buildable, ConstraintTarget

A GtkListBox is a vertical container that contains GtkListBoxRow children.

These rows can by dynamically sorted and filtered, and headers can be added dynamically depending on the row content. It also allows keyboard and mouse navigation and selection like a typical list.

Using GtkListBox is often an alternative to TreeView, especially when the list contents has a more complicated layout than what is allowed by a CellRenderer, or when the contents is interactive (i.e. has a button in it).

Although a ListBox must have only ListBoxRow children you can add any kind of widget to it via prepend, append and insert and a ListBoxRow widget will automatically be inserted between the list and the widget.

ListBoxRows can be marked as activatable or selectable. If a row is activatable, row_activated will be emitted for it when the user tries to activate it. If it is selectable, the row will be marked as selected when the user tries to select it.

GtkListBox as GtkBuildable

The GtkListBox implementation of the Buildable interface supports setting a child as the placeholder by specifying “placeholder” as the “type” attribute of a <child> element. See set_placeholder for info.

CSS nodes

╰── row[.activatable]
istBox uses a single CSS node named list. It may carry the .separators style class, when the show_separators property is set. Each GtkListBoxRow uses a single CSS node named row. The row nodes get the .activatable style class added when appropriate.

The main list node may also carry style classes to select the style of [list presentation](ListContainers.html#list-styles): .rich-list, .navigation-sidebar or .data-table.


GtkListBox uses the LIST role and GtkListBoxRow uses the LIST_ITEM role.

Namespace: Gtk
Package: gtk4



Creation methods:



Inherited Members:

All known members inherited from class Gtk.Widget