RGtk2 (version 2.12.17)

gdkDeviceGetHistory: gdkDeviceGetHistory

Description

Obtains the motion history for a 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.)

Usage

gdkDeviceGetHistory(object, window, start, stop)

Arguments

object

[GdkDevice] a GdkDevice

window

[GdkWindow] the window with respect to which which the event coordinates will be reported

start

[numeric] starting timestamp for range of events to return

stop

[numeric] ending timestamp for the range of events to return

Value

• A list containing the following elements:
• retval
  [logical] TRUE if the windowing system supports motion history and at least one event was found.
• events
  [GdkTimeCoord] location to store a newly-allocated list of GdkTimeCoord, or NULL
• n.events
  [integer] location to store the length of events, or NULL