grab_key/6

     grab_key(+Key, +ModifiersMask, +GrabWindow,
             +OwnerEvents, +PointerMode, +KeyboardMode)
     

Establishes a passive grab on the keyboard, to be activated when the given key and modifiers are pressed while the pointer is in the window.

Key is the key that should be pressed. Possible values are:

An integer

Giving the keycode.

A valid key name

As given by keysym/2.

any_key

ModifiersMask is one of:

An integer

A bitmask giving the state of the modifier masks. The predicate modifiers_mask/2 is useful to translate between modifier specifications and bitmasks.

any_modifier

Window is the ProXL window to which events will be reported while the grab is in effect.

OwnerEvents is one of:

true

If keyboard events should be reported normally.

false

If keyboard events should be reported only to the grab window.

PointerMode controls further processing of pointer events:

async

If pointer event processing continues normally.

sync

If the state of the pointer, as seen by applications appears to freeze. No further pointer events are generated until the grabbing client calls allow_events/[1,2,3] or the pointer grab is released.

KeyboardMode controls further processing of keyboard events:

async

If keyboard event processing continues normally.

sync

If the state of the keyboard, as seen by applications appears to freeze. No further keyboard events are generated until the grabbing client calls allow_events/[1,2,3] or the keyboard grab is released.