Format: AlterMode [mode number]
This command is typically only bound to keys, and can be used to create bindings for sequences of key combinations, instead of just single-stroke key combinations.
The actual AlterMode command switches the editor to any of 10 modes, called "Edit0" through "Edit9". In each mode, keystrokes have different behavior depending on what their binding is for that particular mode. This is useful because it can cause any given key combination to have up to 10 meanings, depending on whether or not it was preceded by a key that is bound to the AlterMode command.
Usually, the keybind command only allows you to bind a command to a key with modifiers such as the Control and Shift keys. However, with AlterMode, you can bind commands to a key sequence. The keybind command requires the specification of an editing mode. When you press the key in that mode, the given command executes. To bind commands to keys to work in the MULTI Editor, the mode should usually be Edit (which refers to the same mode as Edit0). However, if this command is specified and followed by a mode called Edit1-Edit9, then the next key press in the Editor will execute the command that it is bound to for the new mode. For example:
keybind "x"|Control@Edit=SaveFile
keybind "s"|Control@Edit2=RightD
With this command, pressing Ctrl+x in the Editor saves the current file. However, pressing Ctrl+s in the Editor window does nothing because this command only works in mode Edit2. By default, the Editor mode is Edit or Edit0. However, if you enter the command:
keybind "q"|Control@Edit=AlterMode Edit2
then pressing Ctrl+q changes the Editor mode to Edit2 for only the next key press. So if you type Ctrl+q Ctrl+s, the cursor moves to the right one character, the RightD command. Ctrl+s works this time because it is now in the correct mode, Edit2.
Any command issued while in an alternate mode will switch the mode back to Edit0, the default mode.