Next: , Previous: , Up: Events   [Contents][Index]


16.2 Event Modifiers

Sawfish event modifiers are copied directly from the standard X modifiers:

The standard X modifier names are provided, as well as four special modifiers Meta, Alt Hyper and Super that are mapped to the keysyms of the same name.

The following table lists the possible modifier prefixes:

Control
C

The control modifier

Meta
M

The meta modifier

Alt
A

The alt modifier

Shift
S

The shift modifier

Hyper
H

The hyper modifier

Super
s

The super modifier; note that this is a lowercase s, in order to distiguish from shift

Modk

The standard X modifiers, for k between 1 and 5

Any

A special modifier that matches any set of modifiers in events, including no modifier. See Event Matching.

Release

A special modifier that matches key release events, not the default key press events. Mouse events never have Release modifiers; they have separate actions instead. See Event Actions.

You have to set the variable eval-key-release-events to non-nil to use this modifier.

Buttonk

The k’th mouse button is currently pressed.

W

A placeholder “window manager” modifier that can be bound to a real modifier on the fly. See wm-modifier below.

The default Sawfish bindings use the Meta modifier. For convenience, if no X keysym generates Meta, Sawfish will treat the first defined modifier of Alt, Hyper and Super (in that order) as Meta. The mapping from keysyms to modifiers is exposed in the following variables:

Variable: meta-keysyms

A list defining the names of the X keysyms generating the virtual ‘Meta’ or ‘M’ modifier.

Variable: alt-keysyms

A list defining the names of the X keysyms generating the virtual ‘Alt’ or ‘A’ modifier.

Variable: hyper-keysyms

A list defining the names of the X keysyms generating the virtual ‘Hyper’ or ‘H’ modifier.

Variable: super-keysyms

A list defining the names of the X keysyms generating the virtual ‘Super’ modifier.

There are two functions to manipulate the placeholder “window manager” (W) modifier. Unfortunately, these are low-level functions that operate on integer encodings.

Function: wm-modifier

Return the current value (an integer) of the placeholder “window manager” (W) modifier.

Customizable: wm-modifier-value

An integer encoding zero or more modifier keys that form the placeholder “window manager” (W) modifier. Setting this value through the customization UI automatically calls set-wm-modifier.

Function: set-wm-modifier modifiers

Set the value of the placeholder “window manager” (W) modifier to modifiers (an integer).


Next: , Previous: , Up: Events   [Contents][Index]