Keyword: COMBO

COMBO keyLabel [modstring] > function()

or

COMBO deadkey-DK keyLabel [modstring] > function()

deadkey-DK : optional. DK: any real key label. See Function: deadkey()

keyLabel : any key. (New in v70: real modifiers are now possible, too)

modstring : see Modifier Strings

function : any function like Function: key() or Function: altChar()

Use keyword COMBO to define anything beyond simple key A>B mappings.

An incoming key matches a combo IF

• no other combo has matched before
• there is no active deadkey and no deadkey-DK defined, OR the active deadkey = DK
• key event = key down
• incoming key = keyLabel
• state of all modifiers matches with modstring

If the key matches the combo, the function() is triggered.
No other combos or alpha mappings will be evaluated.

Combo triggers on key down, so all resulting key events are written immediately; the "key up" events when releasing the combo are ignored.

Examples

MOD9 + J (with MOD10-12 up) results in cursor left :

COMBO J [^^^& .... ....] > key(LEFT)

Only when the deadkey "C" is active, and both Shift are up, then e results in ê :

COMBO deadkey-C E [...^ ...^] > altChar(0234) # AltGr 0234 = ê

See the file capsicain.example.ini and capsicain.cajhin.ini for a ton of examples.