VirtualBindings(3X) UNIX System V VirtualBindings(3X)
NAME
VirtualBindings - Bindings for virtual mouse and key events.
DESCRIPTION
The OSF/Motif manual pages describe translations in terms of virtual
bindings, based on those described in the OSF/Motif Style Guide. Mouse
events are described in terms of virtual buttons, and key events are
described in terms of virtual keys. The term virtual implies that the
events as described do not necessarily correspond to a fixed set of X
Window System events. Instead, virtual buttons and keys are linked to
actual events by means of virtual bindings.
Virtual Modifiers
Both virtual buttons and virtual keys may contain virtual modifiers.
Each virtual modifier corresponds to one or more actual modifiers. The
following table lists the bindings of virtual modifiers to actual
modifiers in OSF/Motif:
_____________________________________
| Virtual Modifier Bindings |
|_________________|__________________|
| Virtual Modifier| Actual Modifiers|
|_________________|__________________|
|_________________|__________________|
| MAlt | Mod1 |
|_________________|__________________|
| MCtrl | Ctrl |
|_________________|__________________|
| MShift | Shift |
|_________________|__________________|
Mod1 refers to the first modifier key. OSF/Motif requires that it
correspond to either Alt or Meta.
The virtual modifier MAny indicates that any modifier can be used. If
MAny is not specified and the user presses an actual modifier that is not
explicitly included in a translation, that modifier may prevent the
translation from being matched.
Virtual Buttons
Each virtual button corresponds to one or more actual button event
descriptions. Each button event description contains a button name and
possibly modifiers. These button event descriptions, appropriately
ordered and possibly further modified, are used in translation tables.
The following table lists the bindings of virtual buttons to actual
button event descriptions in OSF/Motif:
10/89 Page 1
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
_______________________________________
| Virtual Button Bindings |
|_______________|______________________|
| Virtual Button| Actual Button Events|
|_______________|______________________|
|_______________|______________________|
| BCustom | <Btn3> |
|_______________|______________________|
| BDrag | <Btn2> |
|_______________|______________________|
| BExtend | Shift<Btn1> |
|_______________|______________________|
| BMenu | <Btn3> |
|_______________|______________________|
| BSelect | <Btn1> |
|_______________|______________________|
| BToggle | Ctrl<Btn1> |
|_______________|______________________|
Virtual Keys
Each virtual key corresponds to one or more actual key event
descriptions. Each key event description contains a keysym name and
possibly modifiers. These key event descriptions, appropriately ordered
and possibly further modified, are used in translation tables. The
following table lists the bindings of virtual keys to actual key event
descriptions in OSF/Motif:
Page 2 10/89
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
______________________________________
| Virtual Key Bindings |
|_____________|_______________________|
| Virtual Key | Actual Key Events |
|||
| KActivate | <Key>Return |
| | Ctrl<Key>Return |
| | <Key>osfActivate |
|_____________|_______________________|
| KAddMode | <Key>osfAddMode |
|_____________|_______________________|
| KBackSpace | <Key>osfBackSpace |
|_____________|_______________________|
| KBackTab | Shift<Key>Tab |
|_____________|_______________________|
| KBeginData | Ctrl<Key>osfBeginLine|
|_____________|_______________________|
| KBeginLine | <Key>osfBeginLine |
|_____________|_______________________|
| KCancel | <Key>osfCancel |
|_____________|_______________________|
| KClear | <Key>osfClear |
|_____________|_______________________|
| KCopy | <Key>osfCopy |
| | Ctrl<Key>osfInsert |
|_____________|_______________________|
| KCut | <Key>osfCut |
| | Shift<Key>osfDelete |
|_____________|_______________________|
| KDelete | <Key>osfDelete |
|_____________|_______________________|
| KDeselectAll| Ctrl<Key>backslash |
|_____________|_______________________|
| KDown | <Key>osfDown |
|_____________|_______________________|
| KEndData | Ctrl<Key>osfEndLine |
|_____________|_______________________|
| KEndLine | <Key>osfEndLine |
|_____________|_______________________|
| KEnter | <Key>Return |
|_____________|_______________________|
| KEscape | <Key>Escape |
|_____________|_______________________|
| KExtend | Ctrl Shift<Key>space |
| | Shift<Key>osfSelect |
|_____________|_______________________|
| KHelp | <Key>osfHelp |
|_____________|_______________________|
| KInsert | <Key>osfInsert |
|_____________|_______________________|
10/89 Page 3
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
__________________________________________
| Virtual Key Bindings (Continued) |
|______________|__________________________|
| Virtual Key | Actual Key Events |
|||
| KLeft | <Key>osfLeft |
|______________|__________________________|
| KMenu | <Key>osfMenu |
|______________|__________________________|
| KMenuBar | <Key>osfMenuBar |
|______________|__________________________|
| KNextField | <Key>Tab |
| | Ctrl<Key>Tab |
|______________|__________________________|
| KNextMenu | Ctrl<Key>osfDown |
| | Ctrl<Key>osfRight |
|______________|__________________________|
| KPageDown | <Key>osfPageDown |
|______________|__________________________|
| KPageLeft | Ctrl<Key>osfPageUp |
|______________|__________________________|
| KPageRight | Ctrl<Key>osfPageDown |
|______________|__________________________|
| KPageUp | <Key>osfPageUp |
|______________|__________________________|
| KPaste | <Key>osfPaste |
| | Shift<Key>osfInsert |
|______________|__________________________|
| KPrevField | Shift<Key>Tab |
| | Ctrl Shift<Key>Tab |
|______________|__________________________|
| KPrevMenu | Ctrl<Key>osfUp |
| | Ctrl<Key>osfLeft |
|______________|__________________________|
| KPrimaryCopy | Ctrl<Key>osfPrimaryPaste|
| | Mod1<Key>osfCopy |
| | Mod1 Ctrl<Key>osfInsert |
|______________|__________________________|
| KPrimaryCut | Mod1<Key>osfPrimaryPaste|
| | Mod1<Key>osfCut |
| | Mod1 Shift<Key>osfDelete|
|______________|__________________________|
| KPrimaryPaste| <Key>osfPrimaryPaste |
|______________|__________________________|
| KQuickCopy | Ctrl<Key>osfQuickPaste |
|______________|__________________________|
| KQuickCut | Mod1<Key>osfQuickPaste |
|______________|__________________________|
| KQuickExtend | Shift<Key>osfQuickPaste |
|______________|__________________________|
Page 4 10/89
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
________________________________________
| Virtual Key Bindings (Continued) |
|____________|__________________________|
| Virtual Key| Actual Key Events |
|||
| KQuickPaste| <Key>osfQuickPaste |
|____________|__________________________|
| KReselect | Ctrl Shift<Key>osfSelect|
|____________|__________________________|
| KRestore | Ctrl Shift<Key>osfInsert|
|____________|__________________________|
| KRight | <Key>osfRight |
|____________|__________________________|
| KSelect | <Key>space |
| | Ctrl<Key>space |
| | <Key>osfSelect |
|____________|__________________________|
| KSelectAll | Ctrl<Key>slash |
|____________|__________________________|
| KSpace | <Key>space |
|____________|__________________________|
| KTab | <Key>Tab |
|____________|__________________________|
| KUndo | <Key>osfUndo |
| | Mod1<Key>osfBackSpace |
|____________|__________________________|
| KUp | <Key>osfUp |
|____________|__________________________|
| KAny | <Key> |
|____________|__________________________|
Bindings for osf Keysyms
Keysym strings that begin with "osf" are not part of the X server's
keyboard mapping. Instead, these keysyms are produced on the client side
at run time and are used by the translation manager when the server
delivers an actual key event. A mapping is maintained between "osf"
keysyms and actual keysyms. This mapping is based on information
obtained from one of the following sources, listed in order of
precedence:
⊕ A _MOTIF_BINDINGS property on the root window of screen 0. The Motif
Window Manager sets this property when it starts up, taking the
contents from the .motifbind file in the user's home directory.
⊕ An XmNdefaultVirtualBindings application resource in the resource
database.
⊕ A fixed default based on the vendor string returned by the X server
during the call to XOpenDisplay.
10/89 Page 5
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
⊕ A fixed fallback default.
The format of the specification for mapping "osf" keysyms to actual
keysyms is similar to that of a specification for an event translation.
The syntax is specified here in EBNF notation using the following
conventions:
[a] Means either nothing or a
{a} Means zero or more occurrences of a
Terminals are enclosed in double quotation marks.
The syntax of an "osf" keysym binding specification is as follows:
binding_spec = {line "\n"} [line]
line = virtual_keysym ":" key_event
key_event = {modifier_name} "<Key>" actual_keysym
virtual_keysym = keysym
actual_keysym = keysym
keysym = A valid X11 keysym name that is
mapped by XStringToKeysym
As with event translations, more specific event descriptions must precede
less specific descriptions. For example, an event description for a key
with a modifier must precede a description for the same key without the
same modifier.
Following is an example of a specification for the
XmNdefaultVirtualBindings resource in a resource file:
*defaultVirtualBindings: \
osfBackSpace : <Key>BackSpace\n\
osfInsert : <Key>InsertChar\n\
osfDelete : <Key>DeleteChar
The format of a .motifbind file is the same, except that the binding
specification for each keysym is placed on a separate line. The example
specification above appears as follows in a .motifbind file:
osfBackSpace : <Key>BackSpace
osfInsert : <Key>InsertChar
osfDelete : <Key>DeleteChar
The following table lists the fixed fallback default bindings for "osf"
keysyms:
Page 6 10/89
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
_____________________________________________
Fallback Default Bindings for "osf" Keysyms
_____________________________________________
"osf" Keysym Fallback Default Binding
_____________________________________________
_____________________________________________
osfActivate <unbound>
_____________________________________________
osfAddMode Shift F8
_____________________________________________
osfBackSpace Backspace
_____________________________________________
osfBeginLine Home
_____________________________________________
osfClear Clear
_____________________________________________
osfCopy <unbound>
_____________________________________________
osfCut <unbound>
_____________________________________________
osfDelete Delete
_____________________________________________
osfDown Down
_____________________________________________
osfEndLine End
_____________________________________________
osfCancel Escape
_____________________________________________
osfHelp F1
_____________________________________________
osfInsert Insert
_____________________________________________
osfLeft Left
_____________________________________________
osfMenu F4
_____________________________________________
osfMenuBar F10
_____________________________________________
osfPageDown Next
_____________________________________________
osfPageUp Prior
_____________________________________________
osfPaste <unbound>
_____________________________________________
osfPrimaryPaste <unbound>
_____________________________________________
osfQuickPaste <unbound>
_____________________________________________
osfRight Right
_____________________________________________
osfSelect Select
_____________________________________________
10/89 Page 7
VirtualBindings(3X) UNIX System V VirtualBindings(3X)
| osfUndo | Undo |
|_________________|__________________________|
| osfUp | Up |
|_________________|__________________________|
Page 8 10/89