gtk.list_view.ListView uses its factory to generate one row widget for each visible
item and shows them in a linear display, either vertically or horizontally.
The property@Gtk.ListView:show-separators property offers a simple way to
display separators between the rows.
gtk.list_view.ListView allows the user to select items according to the selection
characteristics of the model. For models that allow multiple selected items,
it is possible to turn on _rubberband selection_, using
property@Gtk.ListView:enable-rubberband.
gtk.list_view.ListView uses a single CSS node named listview. It may carry the
.separators style class, when property@Gtk.ListView:show-separators
property is set. Each child widget uses a single CSS node named row.
If the gtk.list_item.ListItem.gboolean property is set, the
corresponding row will have the .activatable style class. For
rubberband selection, a node with name rubberband is used.
The main listview node may also carry style classes to select
the style of list presentation:
.rich-list, .navigation-sidebar or .data-table.
gtk.list_view.ListView presents a large dynamic list of items.
gtk.list_view.ListView uses its factory to generate one row widget for each visible item and shows them in a linear display, either vertically or horizontally.
The property@Gtk.ListView:show-separators property offers a simple way to display separators between the rows.
gtk.list_view.ListView allows the user to select items according to the selection characteristics of the model. For models that allow multiple selected items, it is possible to turn on _rubberband selection_, using property@Gtk.ListView:enable-rubberband.
If you need multiple columns with headers, see gtk.column_view.ColumnView.
To learn more about the list widget framework, see the overview.
An example of using gtk.list_view.ListView:
CSS nodes
gtk.list_view.ListView uses a single CSS node named listview. It may carry the .separators style class, when property@Gtk.ListView:show-separators property is set. Each child widget uses a single CSS node named row. If the gtk.list_item.ListItem.gboolean property is set, the corresponding row will have the .activatable style class. For rubberband selection, a node with name rubberband is used.
The main listview node may also carry style classes to select the style of list presentation: .rich-list, .navigation-sidebar or .data-table.
Accessibility
gtk.list_view.ListView uses the gtk.types.AccessibleRole.List role, and the list items use the gtk.types.AccessibleRole.ListItem role.