with-mouse-captured

Macro

Package: common-graphics

Arguments: (window) &body body

This macro calls capture-mouse and release-mouse around its body, using an unwind-protect to ensure that the release is always done. capture-mouse causes all mouse events to be directed to the specified window rather than to whatever windows are under the mouse cursor.

An exception is that left-clicking on another window will still expose it. If nested calls to with-mouse-captured are made, then returning from the inner call will restore the capture to the window of the outer call. nil can be passed for window in an inner nested call to with-mouse-captured to temporarily remove the capture of the outer call.

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.