Merge branch 'benzea/foreach-documentation' into 'master'

container: Document that removal from foreach is permissible

Closes #1461

See merge request GNOME/gtk!423
This commit is contained in:
Timm Bäder 2018-11-19 13:38:34 +00:00
commit 40ae5c1319
2 changed files with 4 additions and 1 deletions

View File

@ -1574,6 +1574,8 @@ gtk_container_forall (GtkContainer *container,
* added to the container by the application with explicit add()
* calls.
*
* It is permissible to remove the child from the @callback handler.
*
* Most applications should use gtk_container_foreach(),
* rather than gtk_container_forall().
**/

View File

@ -57,7 +57,8 @@ struct _GtkContainer
* @add: Signal emitted when a widget is added to container.
* @remove: Signal emitted when a widget is removed from container.
* @check_resize: Signal emitted when a size recalculation is needed.
* @forall: Invokes callback on each child of container.
* @forall: Invokes callback on each child of container. The callback handler
* may remove the child.
* @set_focus_child: Sets the focused child of container.
* @child_type: Returns the type of the children supported by the container.
* @set_child_property: Set a property on a child of container.