dropdown: tweak the docs
authorMatthias Clasen <mclasen@redhat.com>
Sat, 18 Mar 2023 14:24:06 +0000 (10:24 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Sat, 18 Mar 2023 14:25:58 +0000 (10:25 -0400)
Add a link to the list widget overview.

gtk/gtkdropdown.c

index 4aaea3ae4a231d24126571f239ded3856e6b0204..3fcfeb71f44713b4587572e137cfcf43907378a4 100644 (file)
  *
  * The options are given to `GtkDropDown` in the form of `GListModel`
  * and how the individual options are represented is determined by
- * a [class@Gtk.ListItemFactory]. The default factory displays simple strings.
+ * a [class@Gtk.ListItemFactory]. The default factory displays simple strings,
+ * and adds a checkmark to the selected item in the popup.
+ *
+ * To set your own factory, use [method@Gtk.DropDown.set_factory]. It is
+ * possible to use a separate factory for the items in the popup, with
+ * [method@Gtk.DropDown.set_list_factory].
  *
  * `GtkDropDown` knows how to obtain strings from the items in a
  * [class@Gtk.StringList]; for other models, you have to provide an expression
@@ -82,6 +87,9 @@
  * </object>
  * ```
  *
+ * To learn more about the list widget framework, see the
+ * [overview](section-list-widget.html).
+ *
  * # CSS nodes
  *
  * `GtkDropDown` has a single CSS node with name dropdown,