with-mouse-confined

Macro

Package: common-graphics

Arguments: (window &optional box) &body body

Confines the mouse-cursor to the region of window specified by box while the body of the macro is executed. When you use this macro, you are guaranteed that the cursor will be freed even if an error occurs in body. Note that confining the mouse is considered by some to be an unfriendly technique (because it prevents using other Windows programs).

The window argument denotes the window within which to confine the mouse cursor. The box argument denotes a region with respect to the exterior of window, and will default to the exterior region of window. Therefore, not passing the box argument will confine the mouse to within the exterior edge of window.

The box argument, if supplied, may be modified by this macro. If you wish to reuse box, copy it before passing it to this macro.

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.