NAME

XtLastTimestampProcessed − retrieve the timestamp from the most recent event handled by XtDispatchEvent() that contains a timestamp. 

Synopsis

Time XtLastTimestampProcessed(display)

      Display *display;

Inputs

displaySpecifies an open display connection. 

Returns

The timestamp of the most recently processed event that contains an event, or zero. 

Availability

Release 4 and later. 

Description

XtLastTimestampProcessed() returns the timestamp of the most recently processed event that contains a timestamp.  If no KeyPress, KeyRelease, ButtonPress, ButtonRelease, MotionNotify, EnterNotify, LeaveNotify, PropertyNotify or SelectionClear event has yet been passed to XtDispatchEvent() for the specified display, XtLastTimestampProcessed() returns zero. 

Usage

The Intrinsics selection handling routines take arguments of type Time.  For ICCCM compliance, these arguments must be the timestamp of the event that triggered the request−the special value CurrentTime is not acceptable.  XtLastTimestampProcessed() is a convenience function added in Release 4 to make it easy to obtain an appropriate timestamp, even from within a callback which is not passed an event.  The function XtGetSelectionRequest() serves a similar purpose for XtSelectionCallback procedures. 

See Also

XtDispatchEvent(1), XtGetSelectionRequest(1), XtGetSelectionValue(1), XtOwnSelection(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates