Keyboard Support

Contact and Search

Keyman.com Homepage

Header bottom

Keyman.com

Other versions
Version 17.0 (current version)Version 16.0Version 15.0Version 14.0Version 13.0Version 12.0Version 11.0Version 10.0

On this page

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)