Package: gio

Function g-list-model-items-changed

Lambda List

g-list-model-items-changed (list position removed added)

Arguments

list -- a g-list-model object
position -- an unsigned integer with the position at which list changed
removed -- an unsigned integer with the number of items removed
added -- an unsigned integer with the number of items added

Details

Emits the "items-changed" signal on list.

This function should only be called by classes implementing the g-list-model interface. It has to be called after the internal representation of list has been updated, because handlers connected to this signal might query the new state of the list.

Implementations must only make changes to the model, as visible to its consumer, in places that will not cause problems for that consumer. For models that are driven directly by a write API, such as the g-list-store object, changes can be reported in response to uses of that API. For models that represent remote data, changes should only be made from a fresh mainloop dispatch. It is particularly not permitted to make changes in response to a call to the g-list-model consumer API.

Stated another way: in general, it is assumed that code making a series of accesses to the model via the API, without returning to the main loop, and without calling other code, will continue to view the same contents of the model.
 

See also

2021-12-10