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:

meta-keysyms

Variable

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

alt-keysyms

Variable

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

hyper-keysyms

Variable

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

super-keysyms

Variable

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.

wm-modifier

Function

Return the current value (an integer) of the placeholder "window manager" (<W>) modifier.

wm-modifier-value

Customizable

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.

set-wm-modifier modifiers

Function

Set the value of the placeholder "window manager" (<W>) modifier to modifiers (an integer).