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

Merge branch 'selection-model-docs' into 'main'

Browse Source 
docs: Fix links in selection models

See merge request GNOME/gtk!4609
This commit is contained in:
Emmanuele Bassi 2022-04-01 11:20:11 +00:00
commit d1ce514260
2 changed files with 10 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
gtk/gtkselectionmodel.c
View File

@ -43,12 +43,14 @@
* [signal@Gtk.SelectionModel::selection-changed] signal by calling the
* [method@Gtk.SelectionModel.selection_changed] function. The positions given
* in that signal may have their selection state changed, though that is not a
* requirement. If new items added to the model via the ::items-changed signal
* are selected or not is up to the implementation.
* requirement. If new items added to the model via the
* [signal@Gio.ListModel::items-changed] signal are selected or not is up to the
* implementation.
*
* Note that items added via ::items-changed may already be selected and no
* [Gtk.SelectionModel::selection-changed] will be emitted for them. So to
* track which items are selected, it is necessary to listen to both signals.
* Note that items added via [signal@Gio.ListModel::items-changed] may already
* be selected and no [signal@Gtk.SelectionModel::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

6
gtk/gtksingleselection.c
View File

@ -32,9 +32,9 @@
* item.
*
* Note that the selection is *persistent* -- if the selected item is removed
* and re-added in the same ::items-changed emission, it stays selected.
* In particular, this means that changing the sort order of an underlying sort
* model will preserve the selection.
* and re-added in the same [signal@Gio.ListModel::items-changed] emission, it
* stays selected. In particular, this means that changing the sort order of an
* underlying sort model will preserve the selection.
*/
struct _GtkSingleSelection
{