summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBastien Nocera <hadess@hadess.net>2021-11-25 12:27:16 +0100
committerBastien Nocera <hadess@hadess.net>2021-11-25 12:33:10 +0100
commit6b3a612bbc7cc0924bf3b8ad45ad12097f28c732 (patch)
treeec69c9755e0234c9913479625364ebc3131da0dc
parentc742debea8d7f2c93f06a5b506851698291cb2da (diff)
downloadgtk+-6b3a612bbc7cc0924bf3b8ad45ad12097f28c732.tar.gz
listbox: Explain behaviour of GtkListBoxCreateWidgetFunc
It might be an interesting shortcut for applications to use, but it needs to be documented to be useful and agreed.
-rw-r--r--gtk/gtklistbox.h3
1 files changed, 3 insertions, 0 deletions
diff --git a/gtk/gtklistbox.h b/gtk/gtklistbox.h
index 0e41498bda..68f02549f6 100644
--- a/gtk/gtklistbox.h
+++ b/gtk/gtklistbox.h
@@ -121,6 +121,9 @@ typedef void (*GtkListBoxUpdateHeaderFunc) (GtkListBoxRow *row,
* Called for list boxes that are bound to a `GListModel` with
* gtk_list_box_bind_model() for each item that gets added to the model.
*
+ * If the widget returned is not a #GtkListBoxRow widget, then the widget
+ * will be inserted as the child of an intermediate #GtkListBoxRow.
+ *
* Returns: (transfer full): a `GtkWidget` that represents @item
*/
typedef GtkWidget * (*GtkListBoxCreateWidgetFunc) (gpointer item,