From: Sonny Piers <sonny@fastmail.net>
Date: Sun, 8 May 2022 20:39:59 +0000 (+0200)
Subject: dropdown: Add UI definition example
X-Git-Tag: archive/raspbian/4.8.3+ds-2+rpi1~3^2~20^2~4^2~206^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=5a0d6e3fc836f39a789406e207bcea99f53cbbb7;p=gtk4.git

dropdown: Add UI definition example
---

diff --git a/gtk/gtkdropdown.c b/gtk/gtkdropdown.c
index 30cb3fa172..e430892db9 100644
--- a/gtk/gtkdropdown.c
+++ b/gtk/gtkdropdown.c
@@ -68,6 +68,21 @@
  * useful if the list of options is long. To enable the search entry,
  * use [method@Gtk.DropDown.set_enable_search].
  *
+ * Here is a UI definition example for `GtkDropDown` with a simple model:
+ * ```xml
+ * <object class="GtkDropDown">
+ *   <property name="model">
+ *     <object class="GtkStringList">
+ *       <items>
+ *         <item translatable="yes">Factory</item>
+ *         <item translatable="yes">Home</item>
+ *         <item translatable="yes">Subway</item>
+ *       </items>
+ *     </object>
+ *   </property>
+ * </object>
+ * ```
+ *
  * # CSS nodes
  *
  * `GtkDropDown` has a single CSS node with name dropdown,