AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

selection model: Further documentation tweaks

Browse Source 
Reword this to use plain language instead of throwing
arond reentrancy and ordering.
This commit is contained in:
Matthias Clasen 2020-06-03 07:51:29 -04:00
parent 667fd927ee
commit 53a9b7f6c0
1 changed files with 3 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
gtk/gtkselectionmodel.c
View File

@ -47,10 +47,9 @@
* If new items added to the model via the #GListModel::items-changed signal are selected
* or not is up to the implementation.
*
* Note that you need to listen to both #GListModel::items-changed and to
* #GtkSelectionModel::selection-changed to keep track of which items are selected.
* #GtkSelectionModel will generally only emit the one or the other signal, not
* both, to avoid ordering and reentrancy issues.
* Note that items added via #GListModel::items-changed may already be selected
* and no #GtkSelectionModel::selection-changed will be emitted for them. So to
* track which items are selected, it is necessary to listen to both signals.
*
* Additionally, the interface can expose functionality to select and unselect items.
* If these functions are implemented, GTK's list widgets will allow users to select and