Next: , Previous: Fixed Point Support, Up: Top

22 ClutterGroup

Actor class containing multiple children. actors.

22.1 Overview

A <clutter-group> is an Actor which contains multiple child actors positioned relative to the <clutter-group> position. Other operations such as scaling, rotating and clipping of the group will apply to the child actors.

A <clutter-group>'s size is defined by the size and position of its children. Resize requests via the <clutter-actor> API will be ignored.

22.2 Usage

— Class: <clutter-group>

Derives from <clutter-container>, <clutter-actor>.

This class defines no direct slots.

— Signal on <clutter-group>: add (arg0 <clutter-actor>)

The ::add signal is emitted each time an actor has been added to the group.

deprecated: 0.4: This signal is deprecated, you should connect to the ClutterContainer::actor-added signal instead.

— Signal on <clutter-group>: remove (arg0 <clutter-actor>)

The ::remove signal is emitted each time an actor has been removed from the group

deprecated: 0.4: This signal is deprecated, you should connect to the ClutterContainer::actor-removed signal instead

— Function: clutter-group-new   (ret <clutter-actor>)

Create a new <clutter-group>.

ret
the newly created <clutter-group> actor
— Function: clutter-group-remove (self <clutter-group>) (actor <clutter-actor>)
— Method: remove

‘clutter_group_remove’ is deprecated and should not be used in newly-written code.

Removes a child <clutter-actor> from the parent <clutter-group>.

deprecated: 0.4: This function is obsolete, use clutter-container-remove-actor instead.

group
A <clutter-group>
actor
A <clutter-actor>
— Function: clutter-group-remove-all (self <clutter-group>)
— Method: remove-all

Removes all children actors from the <clutter-group>.

group
A <clutter-group>
— Function: clutter-group-get-n-children (self <clutter-group>)   (ret int)
— Method: get-n-children

Gets the number of actors held in the group.

self
A <clutter-group>
ret
The number of child actors held in the group.

Since 0.2

— Function: clutter-group-get-nth-child (self <clutter-group>) (index_ int)   (ret <clutter-actor>)
— Method: get-nth-child

Gets a groups child held at index in stack.

self
A <clutter-group>
index
the position of the requested actor.
ret
A Clutter actor or NULL if index is invalid.

Since 0.2

— Function: clutter-group-raise (self <clutter-group>) (actor <clutter-actor>) (sibling <clutter-actor>)
— Method: raise

‘clutter_group_raise’ has been deprecated since version 0.6 and should not be used in newly-written code. Use clutter-container-raise-child instead.

Raises actor to sibling level in the depth ordering.

self
a <clutter-group>
actor
a <clutter-actor>
sibling
a <clutter-actor>
— Function: clutter-group-lower (self <clutter-group>) (actor <clutter-actor>) (sibling <clutter-actor>)
— Method: lower

‘clutter_group_lower’ has been deprecated since version 0.6 and should not be used in newly-written code. Use clutter-container-lower-child instead

Lowers actor to sibling level in the depth ordering.

self
a <clutter-group>
actor
a <clutter-actor>
sibling
a <clutter-actor>
— Function: clutter-group-sort-depth-order (self <clutter-group>)
— Method: sort-depth-order

‘clutter_group_sort_depth_order’ has been deprecated since version 0.6 and should not be used in newly-written code. Use clutter-container-sort-depth-order instead.

Sorts a <clutter-group>'s children by their depth value. This function should not be used by applications.

self
A <clutter-group>