SignalListItemFactory
Superclasses: ListItemFactory
, Object
GtkSignalListItemFactory
is a GtkListItemFactory
that emits signals
to manage listitems.
Signals are emitted for every listitem in the same order:
1.
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.2.
bind
is emitted to bind the item passed viaitem
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.3.
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.4.
bind
andunbind
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.
5. teardown
is emitted to allow undoing
the effects of 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 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
setup
signal and removed again during
teardown
.
Constructors
- class SignalListItemFactory
- classmethod new() ListItemFactory
Creates a new
GtkSignalListItemFactory
.You need to connect signal handlers before you use it.
Signals
- class SignalListItemFactory.signals
- bind(object: Object) None
Emitted when an object has been bound, for example when a new
item
has been set on a listitem and should be bound for use.After this signal was emitted, the object might be shown in a
ListView
or other widget.The
unbind
signal is the opposite of this signal and can be used to undo everything done in this signal.- Parameters:
object – The
GObject
to bind
- setup(object: Object) None
Emitted when a new listitem has been created and needs to be setup for use.
It is the first signal emitted for every listitem.
The
teardown
signal is the opposite of this signal and can be used to undo everything done in this signal.- Parameters:
object – The
GObject
to set up
- teardown(object: Object) None
Emitted when an object is about to be destroyed.
It is the last signal ever emitted for this
object
.This signal is the opposite of the
setup
signal and should be used to undo everything done in that signal.- Parameters:
object – The
GObject
to tear down
- unbind(object: Object) None
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
item
is about to be unset.This signal is the opposite of the
bind
signal and should be used to undo everything done in that signal.- Parameters:
object – The
GObject
to unbind