## CallyStage

CallyStage — Implementation of the ATK interfaces for a ClutterStage

## Synopsis

    struct              CallyStage;
    struct              CallyStageClass;
    AtkObject *         cally_stage_new                     (ClutterActor *actor);

## Object Hierarchy

      GObject
       +----AtkObject
             +----AtkGObjectAccessible
                   +----CallyActor
                         +----CallyGroup
                               +----CallyStage

## Implemented Interfaces

CallyStage implements AtkComponent and AtkAction.

## Signals

      "activate"                                       : Run Last
      "create"                                         : Run Last
      "deactivate"                                     : Run Last
      "destroy"                                        : Run Last

## Description

CallyStage implements the required ATK interfaces for ClutterStage

Some implementation details: at this moment CallyStage is used as the most similar Window object in this toolkit (ie: emitting window related signals), although the real purpose of ClutterStage is being a canvas. Anyway, this is required for applications using just clutter, or directly ClutterStage

## Details

### struct CallyStage

    struct CallyStage;

The CallyStage structure contains only private data and should be accessed using the provided API

Since 1.4

### struct CallyStageClass

    struct CallyStageClass {
    };

The CallyStageClass structure contains only private data

Since 1.4

### cally_stage_new ()

    AtkObject *         cally_stage_new                     (ClutterActor *actor);

Creates a new CallyStage for the given `actor`. `actor` should be a ClutterStage.

`actor` : | a ClutterActor
Returns : | the newly created AtkObject

Since 1.4

## Signal Details

### The `"activate"` signal

    void                user_function                      (CallyStage *cally_actor,
                                                            gpointer    user_data)        : Run Last

The ::activate signal is emitted when the stage receives the key focus from the underlying window system.

Toolkit implementation note: it is used when anyone adds a global event listener to "window:activate"

`cally_actor` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

Since 1.4

### The `"create"` signal

    void                user_function                      (CallyStage *cally_actor,
                                                            gpointer    user_data)        : Run Last

The ::create signal is emitted when the stage is created.

Toolkit implementation note: it is used when anyone adds a global event listener to "window:create"

`cally_actor` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

Since 1.4

### The `"deactivate"` signal

    void                user_function                      (CallyStage *cally_actor,
                                                            gpointer    user_data)        : Run Last

The ::deactivate signal is emitted when the stage loses key focus from the underlying window system.

Toolkit implementation note: it is used when anyone adds a global event listener to "window:deactivate"

`cally_actor` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

Since 1.4

### The `"destroy"` signal

    void                user_function                      (CallyStage *cally_actor,
                                                            gpointer    user_data)        : Run Last

The ::destroy signal is emitted when the stage is destroyed.

Toolkit implementation note: it is used when anyone adds a global event listener to "window:destroy"

`cally_actor` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

Since 1.4

## See Also

ClutterStage