SectionModel

Object Hierarchy:

Description:

[ CCode ( type_cname = "GtkSectionModelInterface" , type_id = "gtk_section_model_get_type ()" ) ]
[ Version ( since = "4.12" ) ]
public interface SectionModel : Object, ListModel

`GtkSectionModel` is an interface that adds support for sections to list models.

A `GtkSectionModel` groups successive items into so-called sections. List widgets like `GtkListView` and `GtkGridView` then allow displaying section headers for these sections by installing a header factory.

Many GTK list models support sections inherently, or they pass through the sections of a model they are wrapping.

When the section groupings of a model change, the model will emit the [signal@Gtk.SectionModel:GtkSectionModel:sections-changed] signal by calling the [method@Gtk.SectionModel.sections_changed] function. All sections in the given range then need to be queried again. The [ signal@Gio.ListModel:GtkSectionModel:items-changed] signal has the same effect, all sections in that range are invalidated, too.

All known implementing classes:

Namespace: Gtk

Package: gtk4

Content:

Methods:

public abstract void get_section (uint position, out uint out_start, out uint out_end)
Query the section that covers the given position.

Signals:

public signal void sections_changed (uint position, uint n_items)
Emitted when the start-of-section state of some of the items in model changes.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface GLib.ListModel

items_changed