Next: , Previous: Event Representation, Up: Events

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
<Modk>
The standard X modifiers, for k between 1 and 5
<Any>
A special modifier that matches any set of modifiers in events. 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.
<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).