## ClutterTapAction

ClutterTapAction — Action for tap gestures

## Synopsis

    struct              ClutterTapAction;
    struct              ClutterTapActionClass;
    ClutterAction *     clutter_tap_action_new              (void);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----ClutterActorMeta
                   +----ClutterAction
                         +----ClutterGestureAction
                               +----ClutterTapAction

## Signals

      "tap"                                            : Run Last

## Description

ClutterTapAction is a sub-class of ClutterGestureAction that implements the logic for recognizing mouse clicks and touch tap gestures.

The simplest usage of ClutterTapAction consists in adding it to a ClutterActor, setting it as reactive and connecting a callback for the "tap" signal, along the lines of the following code:

    1
    2
    3

    clutter_actor_add_action (actor, clutter_tap_action_new ());
    clutter_actor_set_reactive (actor, TRUE);
    g_signal_connect (action, "tap", G_CALLBACK (on_tap_callback), NULL);

## Details

### struct ClutterTapAction

    struct ClutterTapAction;

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

Since 1.14

### struct ClutterTapActionClass

    struct ClutterTapActionClass {
      gboolean (* tap)               (ClutterTapAction    *action,
                                      ClutterActor        *actor);
    };

The ClutterTapActionClass structure contains only private data.

`tap` () | class handler for the "tap" signal

### clutter_tap_action_new ()

    ClutterAction *     clutter_tap_action_new              (void);

Creates a new ClutterTapAction instance

Returns : | the newly created ClutterTapAction

Since 1.14

## Signal Details

### The `"tap"` signal

    void                user_function                      (ClutterTapAction *action,
                                                            ClutterActor     *actor,
                                                            gpointer          user_data)      : Run Last

The ::tap signal is emitted when the tap gesture is complete.

`action` : | the ClutterTapAction that emitted the signal
`actor` : | the ClutterActor attached to the `action`
`user_data` : | user data set when the signal handler was connected.

Since 1.14