container: Document that removal from foreach is permissible

It is permissable to remove a widget using gtk_container_remove from the
gtk_container_foreach callback handler. Document this fact to make it
more discoverable.

Fixes #1461
This commit is contained in:
Benjamin Berg 2018-11-19 13:48:36 +01:00 committed by Daniel Boles
parent 0040b256fe
commit 356f1f59ae
2 changed files with 4 additions and 1 deletions

View File

@ -2456,6 +2456,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

@ -60,7 +60,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.
* @composite_name: Gets a widgets composite name. Deprecated: 3.10.