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.
This commit is contained in:
Bastien Nocera 2021-11-25 12:27:16 +01:00
parent c742debea8
commit 6b3a612bbc

View File

@ -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,