context (KC) (Deprecated)

Summary

(Deprecated) Gets context for an ongoing keyboard operation relative to the caret's present position.

Syntax

keyman.interface.context(n, ln, Pelem);

or

KeymanWeb.KC(n, ln, Pelem); // Shorthand

Parameters

n

Type: number

Relative position of the caret for the context retrieval operation.

ln

Type: number

Number of characters of text context to retrieve.

Pelem

Type: Element

The element being operated upon.

Return Value

string

The requested context text.

Description

For an example from Developer 'rules', a keyboard might implement the following rule

"abc" + "d" > context(2) "D"

by first checking that the initial context ("abc") matches and then using the following to fulfill the rule:

keyman.interface.output(3, Pelem, keyman.interface.context(2, 1, Pelem));
keyman.interface.output(0, Pelem, "D");

This operates by first replacing the original context "abc" with the requested subset of context(2), then outputting the character ("D") corresponding to the new keystroke.

See also

keyman.interface.contextMatch(), keyman.interface.output()