### Method

# Gdk Event get_history

#### Declaration [src]

    GdkTimeCoord*
    gdk_event_get_history (
      GdkEvent* event,
      guint* out_n_coords
    )

#### Description [src]

Retrieves the history of the device that `event` is for, as a list of time and coordinates.

The history includes positions that are not delivered as separate events to the application because they occurred in the same frame as `event`.

Note that only motion and scroll events record history, and motion events do it only if one of the mouse buttons is down, or the device has a tool.

#### Parameters

`out_n_coords`

  Type: `guint*`

  Return location for the length of the returned array.

  The argument will be set by the function.

#### Return value

Type: An array of `GdkTimeCoord`

An array of time and coordinates.

The length of the array is in the `out_n_coords` argument.
The caller of the method takes ownership of the returned data container, but not the data inside it.
The return value can be `NULL`.