GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTDISCARDBUTTONEVENTS (3)

NAME

XmtDiscardButtonEvents(), XmtDiscardKeyPressEvents() - discard pending user input events.

CONTENTS

SYNOPSIS

   #include <Xmt/Xmt.h>

   void XmtDiscardButtonEvents(Widget w)

   void XmtDiscardKeyPressEvents(Widget w)

ARGUMENTS

INPUTS
w Any widget on the display for which events are to be discarded.

DESCRIPTION

XmtDiscardButtonEvents() gets all pending events from the X server, and then removes all ButtonPress, ButtonRelease, ButtonMotion and PointerMotion events from the Xlib event queue, without processing them. It affects events generated in any window of the application on the same display as w.

XmtDiscardKeyPressEvents() removes all pending KeyPress events in the same way. This function does not remove Key Release events, because it may be called from callback or action procedures triggered (through a translation table) by KeyPress events, and the Xt Translation Manager expects to see the corresponding KeyRelease events in order to return to its default state. Calling this function may leave a series of KeyRelease events on the queue, but these will generally will not trigger any translations.

XmtDiscardButtonEvents() can be used to prevent ‘‘click ahead’’ buffering of mouse events while an application is doing any lengthy computation or I/O without servicing events. Similarly, XmtDiscardKeyPressEvents() can be used to prevent ‘‘type-ahead’’. If you will be discarding events, you should be sure to provide feedback to the user that the events will not be processed-display a ‘‘please wait’’ cursor or dialog box. See XmtDisplayBusyCursor() and Xmt DisplayWorkingDialog().

SEE ALSO

Chapter 31, Busy States and Background Work, XmtDisplayBusyCursor(), XmtDisplayWorkingDialog().

Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTDISCARDBUTTONEVENTS (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.