AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-12-27 22:20:24 +00:00
Code Issues Projects Releases Wiki Activity

docs: Add note about stable sorting to SortListModel

Browse Source
This commit is contained in:
Benjamin Otte 2021-10-01 00:31:51 +00:00
parent 2a3a1aaf1e
commit 5c3b368925
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
* 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
* sorting long lists doesn't block the UI. See
* [method@Gtk.SortListModel.set_incremental] for details.