13.  Grab Functions  

(grab-pointer window owner? events ptr-sync? kbd-sync? confine-to cursor time)

See XGrabPointer. window and confine-to are windows. events is a list of symbols (event mask names, such as enter-window, pointer-motion, etc.). ptr-sync? and kbd-sync? determine whether synchronous or asynchronous grab mode is to be used. time is an integer or the symbol now (for CurrentTime). grab-pointer returns a symbol (success, not-viewable, already-grabbed, frozen, or invalid-time).

(ungrab-pointer display time)

See XUngrabPointer.

(grab-button win button mod owner? events ptr-sync? kbd-sync? confine-to cursor)

See XGrabButton. button is a symbol (button1 ... button5, or any-button). mod (modifiers) is a list of symbols (shift, lock, control, mod1 ... mod5, button1 ... button5, or any-modifier). For the other arguments see grab-pointer above.

(ungrab-button window button modifiers)

See XUngrabButton. See grab-button above.

(change-active-pointer-grab display events cursor time)

See XChangeActivePointerGrab. events is a list of symbols (event mask names, such as enter-window, pointer-motion, etc.).

(grab-keyboard window owner? pointer-sync? keyboard-sync? time)

See XGrabKeyboard. For a description of the arguments and the return value see grab-pointer above.

(ungrab-keyboard display time)

See XUngrabKeyboard.

(grab-key window key modifiers owner? pointer-sync? keyboard-sync?)

See XGrabKey. key is a keycode (an integer) or the symbol any. For the other arguments see grab-pointer above.

(ungrab-key window key modifiers)

See XUngrabKey. See grab-key above.

(allow-events display mode time)

See XAllowEvents. mode is a symbol (async-pointer, sync-pointer, replay-pointer, async-keyboard, sync-keyboard, replay-keyboard, async-both, or sync-both).

(grab-server display)

See XGrabServer.

(ungrab-server display)

See XUngrabServer.

(with-server-grabbed display . body-forms)

This macro performs a grab-server on the specified display, evaluates the body-forms in order, and then ungrabs the server. The macro body is guarded by a dynamic-wind to ensure that the ungrab-server is performed when a body-form calls a continuation created outside the macro, and that it is grabbed again when the body is re-entered at a later point in time. with-server-grabbed returns the value of the last body-form.


Markup created by unroff 1.0,    September 24, 1996,    net@informatik.uni-bremen.de