get_history

Description:

public bool get_history (Window window, uint32 start, uint32 stop, out TimeCoord[] events)

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 set_event_compression to get more motion events delivered directly, independent of the windowing system.

Parameters:

this	a Device
window	the window with respect to which which the event coordinates will be reported
start	starting timestamp for range of events to return
stop	ending timestamp for the range of events to return
events	location to store a newly-allocated array of TimeCoord, or null
n_events	location to store the length of `events`, or null

Returns:

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