Method

GdkEventget_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.