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

setStore (KSETS)

Summary

setStore sets the value of a system store to a string.

Syntax

keyman.interface.setStore(systemId, strValue, Pelem);

or

KeymanWeb.KSETS(systemId, strValue, Pelem); // Shorthand

Parameters

systemId
Type: number
The ID of the system store to set. Only system ID 33 (layer) is currently supported.
strValue
Type: string
The string value to set as the system store's content.
Pelem
Type: Element
The page element currently active. (This parameter exists for use by possible future extensions.

Return Value

boolean
true if the operation succeeds, otherwise false.

Description

This function is used to set the value of writeable system stores. Many system stores are readonly, containing metadata about an individual keyboard, so keyman.interface.ifStore() will fail upon attempts to modify their values.

This function cannot modify standard keyboard stores and is limited to system stores only, as standard keyboard stores are optimized into Javascript string literals set directly in code with automatically-generated names.

See also

keyman.interface.ifStore()