NAME¶
Tk_CollapseMotionEvents, Tk_QueueWindowEvent - Add a window event to the Tcl
event queue
SYNOPSIS¶
#include <tk.h>
int
Tk_CollapseMotionEvents(display, collapse)
Tk_QueueWindowEvent(eventPtr, position)
ARGUMENTS¶
- Display *display (in)
- Display for which to control motion event collapsing.
- int collapse (in)
- Indicates whether motion events should be collapsed or not.
- XEvent *eventPtr (in)
- An event to add to the event queue. It is important that all unused fields
of the structure be set to zero.
- Tcl_QueuePosition position (in)
- Where to add the new event in the queue: TCL_QUEUE_TAIL,
TCL_QUEUE_HEAD, or TCL_QUEUE_MARK.
DESCRIPTION¶
Tk_QueueWindowEvent places a window event on Tcl's internal event queue
for eventual servicing. It creates a Tcl_Event structure, copies the event
into that structure, and calls
Tcl_QueueEvent to add the event to the
queue. When the event is eventually removed from the queue it is processed
just like all window events.
When multiple motion events are received for the same window in rapid
succession, they are collapsed by default. This behavior can be controlled
with
Tk_CollapseMotionEvents.
Tk_CollapseMotionEvents always
returns the previous value for collapse behavior on the
display.
The
position argument to
Tk_QueueWindowEvent has the same
significance as for
Tcl_QueueEvent; see the documentation for
Tcl_QueueEvent for details.
KEYWORDS¶
callback, clock, handler, modal timeout, events