with-mouse-captured

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.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.