| Clutter 0.6 Reference Manual | ||||
|---|---|---|---|---|
ClutterContainer;
ClutterContainerIface;
void clutter_container_add_actor (ClutterContainer *container,
ClutterActor *actor);
void clutter_container_add (ClutterContainer *container,
ClutterActor *first_actor,
...);
void clutter_container_add_valist (ClutterContainer *container,
ClutterActor *first_actor,
va_list var_args);
void clutter_container_remove_actor (ClutterContainer *container,
ClutterActor *actor);
void clutter_container_remove (ClutterContainer *container,
ClutterActor *first_actor,
...);
void clutter_container_remove_valist (ClutterContainer *container,
ClutterActor *first_actor,
va_list var_args);
GList* clutter_container_get_children (ClutterContainer *container);
void clutter_container_foreach (ClutterContainer *container,
ClutterCallback callback,
gpointer user_data);
ClutterActor* clutter_container_find_child_by_name
(ClutterContainer *container,
const gchar *child_name);
void clutter_container_raise_child (ClutterContainer *container,
ClutterActor *actor,
ClutterActor *sibling);
void clutter_container_lower_child (ClutterContainer *container,
ClutterActor *actor,
ClutterActor *sibling);
void clutter_container_sort_depth_order (ClutterContainer *container);
ClutterContainer is an interface for writing actors containing other ClutterActors. It provides a standard API for adding, removing and iterating on every contained actor.
An actor implementing ClutterContainer is ClutterGroup.
ClutterContainer is available since Clutter 0.4
typedef struct {
void (* add) (ClutterContainer *container,
ClutterActor *actor);
void (* remove) (ClutterContainer *container,
ClutterActor *actor);
void (* foreach) (ClutterContainer *container,
ClutterCallback callback,
gpointer user_data);
void (* raise) (ClutterContainer *container,
ClutterActor *actor,
ClutterActor *sibling);
void (* lower) (ClutterContainer *container,
ClutterActor *actor,
ClutterActor *sibling);
void (* sort_depth_order) (ClutterContainer *container);
/* signals */
void (* actor_added) (ClutterContainer *container,
ClutterActor *actor);
void (* actor_removed) (ClutterContainer *container,
ClutterActor *actor);
} ClutterContainerIface;
Base interface for container actors.
add () |
virtual function for adding an actor to the container |
remove () |
virtual function for removing an actor from the container |
foreach () |
virtual function for iterating over the container's children |
raise () |
virtual function for raising a child |
lower () |
virtual function for lowering a child |
sort_depth_order () |
virtual function for sorting the children of a container depending on their depth |
actor_added () |
signal class handler for ClutterContainer::actor_added |
actor_removed () |
signal class handler for ClutterContainer::actor_removed |
Since 0.4
void clutter_container_add_actor (ClutterContainer *container, ClutterActor *actor);
Adds a ClutterActor to container. This function will emit the
"actor-added" signal. The actor should be parented to
container. You cannot add a ClutterActor to more than one
ClutterContainer.
container : |
a ClutterContainer |
actor : |
the first ClutterActor to add |
Since 0.4
void clutter_container_add (ClutterContainer *container, ClutterActor *first_actor, ...);
Adds a list of ClutterActors to container. Each time and
actor is added, the "actor-added" signal is emitted. Each actor should
be parented to container, which takes a reference on the actor. You
cannot add a ClutterActor to more than one ClutterContainer.
container : |
a ClutterContainer |
first_actor : |
the first ClutterActor to add |
... : |
NULL terminated list of actors to add
|
Since 0.4
void clutter_container_add_valist (ClutterContainer *container, ClutterActor *first_actor, va_list var_args);
Alternative va_list version of clutter_container_add().
container : |
a ClutterContainer |
first_actor : |
the first ClutterActor to add |
var_args : |
list of actors to add, followed by NULL
|
Since 0.4
void clutter_container_remove_actor (ClutterContainer *container, ClutterActor *actor);
Removes actor from container. The actor should be unparented, so
if you want to keep it around you must hold a reference to it
yourself, using g_object_ref(). When the actor has been removed,
the "actor-removed" signal is emitted by container.
container : |
a ClutterContainer |
actor : |
a ClutterActor |
Since 0.4
void clutter_container_remove (ClutterContainer *container, ClutterActor *first_actor, ...);
Removes a NULL terminated list of ClutterActors from
container. Each actor should be unparented, so if you want to keep it
around you must hold a reference to it yourself, using g_object_ref().
Each time an actor is removed, the "actor-removed" signal is
emitted by container.
container : |
a ClutterContainer |
first_actor : |
first ClutterActor to remove |
... : |
a NULL-terminated list of actors to remove
|
Since 0.4
void clutter_container_remove_valist (ClutterContainer *container, ClutterActor *first_actor, va_list var_args);
Alternative va_list version of clutter_container_remove().
container : |
a ClutterContainer |
first_actor : |
the first ClutterActor to add |
var_args : |
list of actors to remove, followed by NULL
|
Since 0.4
GList* clutter_container_get_children (ClutterContainer *container);
Retrieves all the children of container.
container : |
a ClutterContainer |
| Returns : | a list of ClutterActors. Use g_list_free()
on the returned list when done.
|
Since 0.4
void clutter_container_foreach (ClutterContainer *container, ClutterCallback callback, gpointer user_data);
Calls callback for each child of container.
container : |
a ClutterContainer |
callback : |
a function to be called for each child |
user_data : |
data to be passed to the function, or NULL
|
Since 0.4
ClutterActor* clutter_container_find_child_by_name (ClutterContainer *container, const gchar *child_name);
Finds a child actor of a container by its name. Search recurses into any child container.
container : |
a ClutterContainer |
child_name : |
the name of the requested child. |
| Returns : | The child actor with the requested name, or NULL if no
actor with that name was found.
|
Since 0.6
void clutter_container_raise_child (ClutterContainer *container, ClutterActor *actor, ClutterActor *sibling);
Raises actor to sibling level, in the depth ordering.
container : |
a ClutterContainer |
actor : |
the actor to raise |
sibling : |
the sibling to raise to, or NULL to raise to the top
|
Since 0.6
void clutter_container_lower_child (ClutterContainer *container, ClutterActor *actor, ClutterActor *sibling);
Lowers actor to sibling level, in the depth ordering.
container : |
a ClutterContainer |
actor : |
the actor to raise |
sibling : |
the sibling to lower to, or NULL to lower to the bottom
|
Since 0.6
void clutter_container_sort_depth_order (ClutterContainer *container);
Sorts a container's children using their depth. This function should not be normally used by applications.
container : |
a ClutterContainer |
Since 0.6