Method

GdkDeviceget_history

Declaration [src]

gboolean
gdk_device_get_history (
  GdkDevice* device,
  GdkWindow* window,
  guint32 start,
  guint32 stop,
  GdkTimeCoord*** events,
  gint* n_events
)

Description [src]

Obtains the motion history for a pointer device; given a starting and ending timestamp, return all events in the motion history for the device in the given range of time. Some windowing systems do not support motion history, in which case, FALSE will be returned. (This is not distinguishable from the case where motion history is supported and no events were found.)

Note that there is also gdk_window_set_event_compression() to get more motion events delivered directly, independent of the windowing system.

This method is not directly available to language bindings.

Parameters

window

Type: GdkWindow

The window with respect to which which the event coordinates will be reported.

The data is owned by the caller of the method.
start

Type: guint32

Starting timestamp for range of events to return.

stop

Type: guint32

Ending timestamp for the range of events to return.

events

Type: An array of GdkTimeCoord**

location to store a newly-allocated array of GdkTimeCoord, or NULL.

The argument will be set by the function.
The argument can be NULL.
The length of the array is specified in the n_events argument.
The caller of the method takes ownership of the returned data, and is responsible for freeing it.
n_events

Type: gint*

Location to store the length of events, or NULL.

The argument will be set by the function.
The argument can be NULL.

Return value

Type: gboolean

TRUE if the windowing system supports motion history and at least one event was found.