Synopsis: showKeyNames( )
Show the key names as they are compared when triggering
key bindings. The key names consist of the eight
modifier bits and the key's normal name. Let's make
that clear using an example...
Assume that you want to write "kill bunny" to the mud
everytime you press shift-F3. Now at the command line
type
#showKeyNames()
Then press shift-F3. You'll see something like
00000000 Shift_L
10000000 F3
The first is the key press event generated when pressing
the shift key, the second is the shift-F3 event. Note
that the first 1 means that the shift key is hold down.
Now press "x" to leave the key name mode.
So, now we know on what we have to match. A keybinding
will be triggered whenever the specified regexp matches
the key name we've just seen. So
#addKeyBinding("MySlay", "^10000000 F3\$", "kill bunny")
will do exactly what we want. Nearly.
Try the following:
#showKeyNames()
Press the caps-lock key.
Press some other key.
You see? The caps-lock key generates a modifier. So
the above example wouldn't work if caps-lock is active.
To prevent this we just write
#addKeyBinding("MySlay", "^1.0..... F3\$", "kill bunny");
Now this will cause the client to write "kill bunny"
whenever the shift key is hold down while pressing F3 and
the ctrl-key is _not_ pressed, but any other modifier may
be present.
