Memory-managed wrapper type.

Construct a ActorIter struct initialized to zero.

Safely destroys the Actor currently pointer to by the iterator from its parent.

This function can only be called after actorIterNext or actorIterPrev returned True, and cannot be called more than once for the same actor.

This function will call actorDestroy internally.

Since: 1.10

Initializes a ActorIter, which can then be used to iterate efficiently over a section of the scene graph, and associates it with root.

Modifying the scene graph section that contains root will invalidate the iterator.

C code

 ClutterActorIter iter;
 ClutterActor *child;

 clutter_actor_iter_init (&iter, container);
 while (clutter_actor_iter_next (&iter, &child))
   {
     // do something with child
   }

Since: 1.10

Checks whether a ActorIter is still valid.

An iterator is considered valid if it has been initialized, and if the Actor that it refers to hasn't been modified after the initialization.

Since: 1.12

Advances the iter and retrieves the next child of the root Actor that was used to initialize the ClutterActorIterator.

If the iterator can advance, this function returns True and sets the child argument.

If the iterator cannot advance, this function returns False, and the contents of child are undefined.

Since: 1.10

Advances the iter and retrieves the previous child of the root Actor that was used to initialize the ClutterActorIterator.

If the iterator can advance, this function returns True and sets the child argument.

If the iterator cannot advance, this function returns False, and the contents of child are undefined.

Since: 1.10

Safely removes the Actor currently pointer to by the iterator from its parent.

This function can only be called after actorIterNext or actorIterPrev returned True, and cannot be called more than once for the same actor.

This function will call actorRemoveChild internally.

Since: 1.10