setKeyboardForControl

Summary

Associate control with independent keyboard settings initialized to a specific keyboard.

Syntax

keyman.setDefaultKeyboardForControl(Pelem, keyboard, languageCode);

Parameters

Pelem

Type: Element

The control element to be managed manually.

keyboard

Type: string optional

The ID (internal name) of a keyboard.

languageCode

Type: string optional

The three-letter language code for the keyboard.

Return Value

undefined

Description

This function establishes the control with separately-managed keyboard settings from other, non-specialized controls on the page. This may be undone by setting both keyboard and languageCode to null, reverting the control back to default keyboard-management behavior.

Note that either both parameters should be set or neither. In particular, if languageCode is specified but not keyboard, this method will not automatically select an appropriate keyboard, even if one has previously been registered with that language code.

Due to system limitations, this function will fail if called on an IFRAME element.

See also Control-by-Control Example (guide)