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

Merge branch 'otte/for-master2' into 'master'

Browse Source 
docs: Add note about stable sorting to SortListModel

See merge request GNOME/gtk!4017
This commit is contained in:
Benjamin Otte 2021-10-01 02:49:11 +00:00
commit 72bbc51ba9
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
gtk/gtksortlistmodel.c
View File

@ -58,6 +58,13 @@
* A `GListModel` that sorts the elements of an underlying model * A `GListModel` that sorts the elements of an underlying model
* according to a `GtkSorter`. * according to a `GtkSorter`.
* *
* The model is a stable sort. If two items compare equal according
* to the sorter, the one that appears first in the original model will
* also appear first after sorting.
* Note that if you change the sorter, the previous order will have no
* influence on the new order. If you want that, consider using a
* `GtkMultiSorter` and appending the previous sorter to it.
*
* The model can be set up to do incremental sorting, so that * The model can be set up to do incremental sorting, so that
* sorting long lists doesn't block the UI. See * sorting long lists doesn't block the UI. See
* [method@Gtk.SortListModel.set_incremental] for details. * [method@Gtk.SortListModel.set_incremental] for details.