Clutter.Stage.grab

### Method

# Clutter Stagegrab

#### Declaration [src]

    ClutterGrab*
    clutter_stage_grab (
      ClutterStage* stage,
      ClutterActor* actor
    )

#### Description [src]

Grabs input onto a certain actor. Events will be propagated as usual inside its hierarchy.

#### Parameters

`actor` | `ClutterActor`
| The actor grabbing input.
| The data is owned by the caller of the function.

#### Return value

Returns: | `ClutterGrab`
| An opaque `ClutterGrab` handle, drop with `clutter_grab_dismiss()`
| The caller of the method takes ownership of the data, and is responsible for freeing it.