You can make certain keystrokes perform actions in SpaceMonger.
For example, you can make SpaceMonger always Refresh its display when the
"F5" key is pressed. Or if "F5" sounds strange to you, you can bind the
action to something more comprehensible, like "Ctrl+R". Or "Ctrl+Shift+R".
Or "Ctrl+Alt+Shift+F11". You can pick any keys you want for any action
you want by naming the keys in the key-binding table.
(The key-binding table is part of the language file because different
keys may make sense for different languages. For example, in English,
Print would probably be bound to "Ctrl+P" because "Ctrl+P" is easy to
remember. However, in French, the word "print" is translated as "imprimer",
so in French, "Ctrl+I" might make more sense. It's up to you to decide
what makes the most sense for you.)
The key-binding table is a tag that looks like this:
|
<![CDATA[
<key-bindings>
...
one key binding per line
...
</key-bindings>
]]>
|
Unlike the menus, the key-binding table must not be contained within any
<group> tag. You may have multiple
<key-bindings> tags in one file. If the
same key is defined more than once, the last definition will be
the one that is used.
Each key binding consists of a named key and an action to perform, and
looks like this:
|
<![CDATA[
<key name="F5" action="refresh"/>
]]>
|
The action can be any Action that SpaceMonger recognizes (see
Section 6). The key's name is case-insensitive and can be any
name in the following list:
|
<![CDATA[
A B C D E F G H I J K L M
N O P Q R S T U V W X Y Z
0 1 2 3 4 5 6 7 8 9
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12
Tab Enter Escape Backspace Up Down Left Right
Insert Delete Home End PageUp PageDown
Tilde Comma Period Slash Colon Quote Space
LeftBracket RightBracket Hyphen Equals Backslash
Num0 Num1 Num2 Num3 Num4 Num5 Num6 Num7 Num8 Num9
NumDiv NumMul NumSub NumAdd NumEnter NumPeriod
]]>
|
Note that keys are considered to be the same whether shifted or unshifted;
so on an English keyboard, the apostrophe key is the same as the "Quote" key
whether the shift key is held down or not. This is why many shifted
keystrokes are not listed. If your keyboard contains keys that are not
on this list, they cannot be used for key-binding.
You may also prepend modifiers to the key name to define a composite
keystroke:
- Shift- or Shift+ --- User must hold
down either shift key.
- Ctrl- or Ctrl+ --- User must hold
down either control key.
- Alt- or Alt+ --- User must hold
down either alt key.
You should probably not bind plain keys like "C", or even "Shift+C",
because bindings take precedence over all other keystrokes. This means
that if you did bind "C" to do something (like close the program, for example), you would be
unable to type "C:\" into the Location bar, because when you press the
"C" key, SpaceMonger will perform its action rather than entering it into the
Location bar. Thus if you want to bind common keys like "C", you should use a
modifier like "Alt+" or "Ctrl+" also.