docs: Update list widgets docs

Removed sentence that claimed the view will wrap the model in a
GtkSingleSelection, as it's no longer true. Fixed the code example in
GtkListView for the same reason. Fixed a small typo in GtkDropDown docs.
This commit is contained in:
Andreas Persson 2020-09-06 17:19:24 +02:00
parent 007c9c6218
commit e0134aaf15
4 changed files with 12 additions and 15 deletions

View File

@ -58,10 +58,9 @@
* separators between the rows or columns. * separators between the rows or columns.
* *
* GtkColumnView allows the user to select items according to the selection * GtkColumnView allows the user to select items according to the selection
* characteristics of the model. If the provided model is not a #GtkSelectionModel, * characteristics of the model. For models that allow multiple selected items,
* GtkColumnView will wrap it in a #GtkSingleSelection. For models that allow * it is possible to turn on *rubberband selection*, using
* multiple selected items, it is possible to turn on *rubberband selection*, * #GtkColumnView:enable-rubberband.
* using #GtkColumnView:enable-rubberband.
* *
* The column view supports sorting that can be customized by the user by * The column view supports sorting that can be customized by the user by
* clicking on column headers. To set this up, the #GtkSorter returned by * clicking on column headers. To set this up, the #GtkSorter returned by

View File

@ -909,7 +909,7 @@ gtk_drop_down_get_enable_search (GtkDropDown *self)
* *
* Sets the expression that gets evaluated to obtain strings from items * Sets the expression that gets evaluated to obtain strings from items
* when searching in the popup. The expression must have a value type of * when searching in the popup. The expression must have a value type of
* #GTK_TYPE_STRING. * #G_TYPE_STRING.
*/ */
void void
gtk_drop_down_set_expression (GtkDropDown *self, gtk_drop_down_set_expression (GtkDropDown *self,

View File

@ -55,10 +55,9 @@
* grid reflows vertically or horizontally. * grid reflows vertically or horizontally.
* *
* GtkGridView allows the user to select items according to the selection * GtkGridView allows the user to select items according to the selection
* characteristics of the model. If the provided model is not a #GtkSelectionModel, * characteristics of the model. For models that allow multiple selected items,
* GtkGridView will wrap it in a #GtkSingleSelection. For models that allow * it is possible to turn on _rubberband selection_, using
* multiple selected items, it is possible to turn on _rubberband selection_, * #GtkGridView:enable-rubberband.
* using #GtkGridView:enable-rubberband.
* *
* To learn more about the list widget framework, see the [overview](#ListWidget). * To learn more about the list widget framework, see the [overview](#ListWidget).
* *

View File

@ -54,10 +54,9 @@
* between the rows. * between the rows.
* *
* GtkListView allows the user to select items according to the selection * GtkListView allows the user to select items according to the selection
* characteristics of the model. If the provided model is not a #GtkSelectionModel, * characteristics of the model. For models that allow multiple selected items,
* GtkListView will wrap it in a #GtkSingleSelection. For models that allow * it is possible to turn on _rubberband selection_, using
* multiple selected items, it is possible to turn on _rubberband selection_, * #GtkListView:enable-rubberband.
* using #GtkListView:enable-rubberband.
* *
* If you need multiple columns with headers, see #GtkColumnView. * If you need multiple columns with headers, see #GtkColumnView.
* *
@ -95,7 +94,7 @@
* { * {
* GAppInfo *app_info; * GAppInfo *app_info;
* *
* app_info = g_list_model_get_item (gtk_list_view_get_model (list), position); * app_info = g_list_model_get_item (G_LIST_MODEL (gtk_list_view_get_model (list)), position);
* g_app_info_launch (app_info, NULL, NULL, NULL); * g_app_info_launch (app_info, NULL, NULL, NULL);
* g_object_unref (app_info); * g_object_unref (app_info);
* } * }
@ -108,7 +107,7 @@
* g_signal_connect (factory, "setup", G_CALLBACK (setup_listitem_cb), NULL); * g_signal_connect (factory, "setup", G_CALLBACK (setup_listitem_cb), NULL);
* g_signal_connect (factory, "bind", G_CALLBACK (bind_listitem_cb), NULL); * g_signal_connect (factory, "bind", G_CALLBACK (bind_listitem_cb), NULL);
* *
* list = gtk_list_view_new (model, factory); * list = gtk_list_view_new (GTK_SELECTION_MODEL (gtk_single_selection_new (model)), factory);
* *
* g_signal_connect (list, "activate", G_CALLBACK (activate_cb), NULL); * g_signal_connect (list, "activate", G_CALLBACK (activate_cb), NULL);
* *