Mark nullable arguments in GtkPaned
authorEmmanuele Bassi <ebassi@gnome.org>
Thu, 14 Apr 2022 21:44:17 +0000 (22:44 +0100)
committerEmmanuele Bassi <ebassi@gnome.org>
Thu, 14 Apr 2022 21:44:17 +0000 (22:44 +0100)
The set_start_child() and set_end_child() methods take NULL for the
child argument, as a way to remove the child from the paned widget.

gtk/gtkpaned.c

index ccea91f92c3bf47e63db95b644104a8291830231..bc7591a3d75f427bc19630710f5391f4519a8504 100644 (file)
@@ -1571,9 +1571,11 @@ gtk_paned_new (GtkOrientation orientation)
 /**
  * gtk_paned_set_start_child: (attributes org.gtk.Method.set_property=start-child)
  * @paned: a `GtkPaned`
- * @child: the widget to add
+ * @child: (nullable): the widget to add
  *
  * Sets the start child of @paned to @child.
+ *
+ * If @child is `NULL`, the existing child will be removed.
  */
 void
 gtk_paned_set_start_child (GtkPaned *paned,
@@ -1686,9 +1688,11 @@ gtk_paned_get_shrink_start_child (GtkPaned *paned)
 /**
  * gtk_paned_set_end_child: (attributes org.gtk.Method.set_property=end-child)
  * @paned: a `GtkPaned`
- * @child: the widget to add
+ * @child: (nullable): the widget to add
  *
  * Sets the end child of @paned to @child.
+ *
+ * If @child is `NULL`, the existing child will be removed.
  */
 void
 gtk_paned_set_end_child (GtkPaned *paned,