From: Benjamin Otte <otte@redhat.com>
Date: Sun, 26 Mar 2023 19:06:09 +0000 (+0200)
Subject: treeexpander: Add docs note about setting GtkListItem::focusable
X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~1^2~461^2~18
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=5f1b8a31c23d8eeacae1ca18cbcb9f8b6d824eaa;p=gtk4.git

treeexpander: Add docs note about setting GtkListItem::focusable
---

diff --git a/gtk/gtktreeexpander.c b/gtk/gtktreeexpander.c
index 86230e4028..66a520b95c 100644
--- a/gtk/gtktreeexpander.c
+++ b/gtk/gtktreeexpander.c
@@ -45,6 +45,11 @@
  * "listitem.toggle-expand" actions are provided to allow adding custom
  * UI for managing expanded state.
  *
+ * It is important to mention that you want to set the
+ * [property@Gtk.ListItem:focusable] property to FALSE when using this
+ * widget, as you want the keyboard focus to be in the treexpander, and not
+ * inside the list to make use of the keybindings.
+ *
  * The `GtkTreeListModel` must be set to not be passthrough. Then it
  * will provide [class@Gtk.TreeListRow] items which can be set via
  * [method@Gtk.TreeExpander.set_list_row] on the expander.