wait-for-mouse-buttons-up

Function

Package: common-graphics

Arguments: nil

Waits until no mouse buttons are down and then returns. It may be useful to call this function just before calling a function like get-position or get-box to ensure that a mouse-up from some previous activity does not also terminate the call to get-position or get-box.

Compatibility note: In ACLWIN 3.0.x, wait-for-mouse-buttons-up called process-pending-events as it waited for the mouse buttons to be unpressed, which allowed arbitrary other incoming events to be processed as usual in the meantime. This is no longer the case, largely because the get-position family of functions with which it is typically used now work synchronously and so do not depend on asynchronous events to be handled in the meantime. Intervening events will now be queued up until wait-for-mouse-buttons-up returns and processed at that time.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.