gtk4/org.gtkkn.bindings.gtk/SignalListItemFactory

SignalListItemFactory

open class SignalListItemFactory(pointer: <Error class: unknown class><<Error class: unknown class>>) : ListItemFactory

GtkSignalListItemFactory is a GtkListItemFactory that emits signals to manage listitems.

Signals are emitted for every listitem in the same order:

signal@Gtk.SignalListItemFactory::setup is emitted to set up permanent things on the listitem. This usually means constructing the widgets used in the row and adding them to the listitem.
signal@Gtk.SignalListItemFactory::bind is emitted to bind the item passed via property@Gtk.ListItem:item to the widgets that have been created in step 1 or to add item-specific widgets. Signals are connected to listen to changes - both to changes in the item to update the widgets or to changes in the widgets to update the item. After this signal has been called, the listitem may be shown in a list widget.
signal@Gtk.SignalListItemFactory::unbind is emitted to undo everything done in step 2. Usually this means disconnecting signal handlers. Once this signal has been called, the listitem will no longer be used in a list widget.
signal@Gtk.SignalListItemFactory::bind and signal@Gtk.SignalListItemFactory::unbind may be emitted multiple times again to bind the listitem for use with new items. By reusing listitems, potentially costly setup can be avoided. However, it means code needs to make sure to properly clean up the listitem in step 3 so that no information from the previous use leaks into the next use.
signal@Gtk.SignalListItemFactory::teardown is emitted to allow undoing the effects of signal@Gtk.SignalListItemFactory::setup. After this signal was emitted on a listitem, the listitem will be destroyed and not be used again.

Note that during the signal emissions, changing properties on the listitems passed will not trigger notify signals as the listitem's notifications are frozen. See g_object_freeze_notify() for details.

For tracking changes in other properties in the listitem, the ::notify signal is recommended. The signal can be connected in the signal@Gtk.SignalListItemFactory::setup signal and removed again during signal@Gtk.SignalListItemFactory::teardown.

Constructors

SignalListItemFactory

constructor()

Creates a new GtkSignalListItemFactory.

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion

Properties

gtkListItemFactoryPointer

val gtkListItemFactoryPointer: <Error class: unknown class><<Error class: unknown class>>

gtkSignalListItemFactoryPointer

val gtkSignalListItemFactoryPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

connectBind

fun connectBind(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (<Error class: unknown class>) -> Unit): <Error class: unknown class>

Emitted when an object has been bound, for example when a new property@Gtk.ListItem:item has been set on a listitem and should be bound for use.

connectSetup

fun connectSetup(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (<Error class: unknown class>) -> Unit): <Error class: unknown class>

Emitted when a new listitem has been created and needs to be setup for use.

connectTeardown

fun connectTeardown(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (<Error class: unknown class>) -> Unit): <Error class: unknown class>

Emitted when an object is about to be destroyed.

connectUnbind

fun connectUnbind(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (<Error class: unknown class>) -> Unit): <Error class: unknown class>

Emitted when an object has been unbound from its item, for example when a listitem was removed from use in a list widget and its property@Gtk.ListItem:item is about to be unset.