Clutter.Event
Description: Reference for Clutter.Event

### Struct

# ClutterEvent

#### Description [src]

    union ClutterEvent {
      /* No available fields */
    }

Generic event wrapper.

Available since: | 0.2

#### Constructors

###### clutter_event_new

Creates a new `ClutterEvent` of the specified type.

#### Functions

###### clutter_event_add_filter

Adds a function which will be called for all events that Clutter processes. The function will be called before any signals are emitted for the event and it will take precedence over any grabs.

Available since: 1.18

###### clutter_event_get

Pops an event off the event queue. Applications should not need to call this.

Available since: 0.4

###### clutter_event_remove_filter

Removes an event filter that was previously added with clutter_event_add_filter().

Available since: 1.18

#### Instance methods

###### clutter_event_copy

Copies `event`.

###### clutter_event_free

Frees all resources used by `event`.

###### clutter_event_get_angle

Retrieves the angle relative from `source` to `target`.

Available since: 1.12

###### clutter_event_get_axes

Retrieves the array of axes values attached to the event.

Available since: 1.6

###### clutter_event_get_button

Retrieves the button number of `event`.

Available since: 1.0

###### clutter_event_get_coords

Retrieves the coordinates of `event` and puts them into `x` and `y`.

Available since: 0.4

###### clutter_event_get_device

Retrieves the `ClutterInputDevice` for the event. If you want the physical device the event originated from, use clutter_event_get_source_device().

Available since: 1.0

###### clutter_event_get_device_tool

Returns the device tool that originated this event.

Available since: 1.28

###### clutter_event_get_device_type

Retrieves the type of the device for `event`.

Available since: 1.0

###### clutter_event_get_distance

Retrieves the distance between two events, a `source` and a `target`.

Available since: 1.12

###### clutter_event_get_event_code

No description available.

###### clutter_event_get_event_sequence

Retrieves the `ClutterEventSequence` of `event`.

Available since: 1.10

###### clutter_event_get_flags

Retrieves the `ClutterEventFlags` of `event`.

Available since: 1.0

###### clutter_event_get_gesture_motion_delta

Returns the gesture motion deltas relative to the current pointer position.

Available since: 1.24

###### clutter_event_get_gesture_motion_delta_unaccelerated

Returns the unaccelerated gesture motion deltas relative to the current pointer position. Unlike clutter_event_get_gesture_motion_delta(), pointer acceleration is ignored.

###### clutter_event_get_gesture_phase

Returns the phase of the event, See `ClutterTouchpadGesturePhase`.

###### clutter_event_get_gesture_pinch_angle_delta

Returns the angle delta reported by this specific event.

Available since: 1.24

###### clutter_event_get_gesture_pinch_scale

Returns the current scale as reported by `event`, 1.0 being the original distance at the time the corresponding event with phase `CLUTTER_TOUCHPAD_GESTURE_PHASE_BEGIN` is received. is received.

Available since: 1.24

###### clutter_event_get_key_code

Retrieves the keycode of the key that caused `event`.

Available since: 1.0

###### clutter_event_get_key_symbol

Retrieves the key symbol of `event`.

Available since: 1.0

###### clutter_event_get_key_unicode

Retrieves the unicode value for the key that caused `keyev`.

###### clutter_event_get_mode_group

No description available.

###### clutter_event_get_pad_event_details

Returns the details of a pad event.

###### clutter_event_get_position

Retrieves the event coordinates as a #graphene_point_t.

Available since: 1.12

###### clutter_event_get_related

Retrieves the related actor of a crossing event.

Available since: 1.0

###### clutter_event_get_relative_motion

No description available.

###### clutter_event_get_scroll_delta

Retrieves the precise scrolling information of `event`.

Available since: 1.10

###### clutter_event_get_scroll_direction

Retrieves the direction of the scrolling of `event`.

Available since: 1.0

###### clutter_event_get_scroll_finish_flags

Returns the `ClutterScrollFinishFlags` of an scroll event. Those can be used to determine whether post-scroll effects like kinetic scrolling should be applied.

Available since: 1.26

###### clutter_event_get_scroll_source

Returns the `ClutterScrollSource` that applies to an scroll event.

Available since: 1.26

###### clutter_event_get_source

Retrieves the source `ClutterActor` the event originated from, or NULL if the event has no source.

Available since: 0.6

###### clutter_event_get_source_device

Retrieves the hardware device that originated the event.

Available since: 1.6

###### clutter_event_get_stage

Retrieves the source `ClutterStage` the event originated for, or `NULL` if the event has no stage.

Available since: 0.8

###### clutter_event_get_state

Retrieves the modifier state of the event. In case the window system supports reporting latched and locked modifiers, this function returns the effective state.

Available since: 0.4

###### clutter_event_get_state_full

Retrieves the decomposition of the keyboard state into button, base, latched, locked and effective. This can be used to transmit to other applications, for example when implementing a wayland compositor.

Available since: 1.16

###### clutter_event_get_time

Retrieves the time of the event.

Available since: 0.4

###### clutter_event_get_time_us

No description available.

###### clutter_event_get_touchpad_gesture_finger_count

Returns the number of fingers that is triggering the touchpad gesture.

Available since: 1.24

###### clutter_event_has_control_modifier

Checks whether `event` has the Control modifier mask set.

Available since: 1.12

###### clutter_event_has_shift_modifier

Checks whether `event` has the Shift modifier mask set.

Available since: 1.12

###### clutter_event_is_pointer_emulated

Checks whether a pointer `event` has been generated by the windowing system. The returned value can be used to distinguish between events synthesized by the windowing system itself (as opposed by Clutter).

Available since: 1.12

###### clutter_event_put

Puts a copy of the event on the back of the event queue. The event will have the `CLUTTER_EVENT_FLAG_SYNTHETIC` flag set. If the source is set event signals will be emitted for this source and capture/bubbling for its ancestors. If the source is not set it will be generated by picking or use the actor that currently has keyboard focus.

Available since: 0.6

###### clutter_event_set_button

Sets the button number of `event`.

Available since: 1.8

###### clutter_event_set_coords

Sets the coordinates of the `event`.

Available since: 1.8

###### clutter_event_set_device

Sets the device for `event`.

Available since: 1.6

###### clutter_event_set_device_tool

Sets the tool in use for this event.

Available since: 1.28

###### clutter_event_set_flags

Sets the `ClutterEventFlags` of `event`.

Available since: 1.8

###### clutter_event_set_key_code

Sets the keycode of the `event`.

Available since: 1.8

###### clutter_event_set_key_symbol

Sets the key symbol of `event`.

Available since: 1.8

###### clutter_event_set_key_unicode

Sets the Unicode value of `event`.

Available since: 1.8

###### clutter_event_set_related

Sets the related actor of a crossing event.

Available since: 1.8

###### clutter_event_set_scroll_delta

Sets the precise scrolling information of `event`.

Available since: 1.10

###### clutter_event_set_scroll_direction

Sets the direction of the scrolling of `event`.

Available since: 1.8

###### clutter_event_set_source

Sets the source `ClutterActor` of `event`.

Available since: 1.8

###### clutter_event_set_source_device

Sets the source `ClutterInputDevice` for `event`.

Available since: 1.8

###### clutter_event_set_stage

Sets the source `ClutterStage` of the event.

Available since: 1.8

###### clutter_event_set_state

Sets the modifier state of the event.

Available since: 1.8

###### clutter_event_set_time

Sets the time of the event.

Available since: 1.8

###### clutter_event_type

Retrieves the type of the event.