spiegel-keyman/web/docs/engine/reference/interface/setStore.md at e9a85dfd2f8f3bf6bcc0ade07a1cfee06ecc00b2

mirror of https://github.com/keymanapp/keyman.git synced 2026-08-05 16:35:33 +00:00

Marc Durdin 6c145cb775 refactor(web): move web engine help to app repo

Note: build.sh updated to make sure that test:help build action:target
doesn't also call test.sh by adding `:_all` meta-target.

Note: CI will need a new help-keyman-com.sh build step to deploy web
engine help.

Fixes: #12347

2024-10-31 11:00:06 +07:00

1.3 KiB

Raw Blame History

title
setStore (KSETS)

Summary

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

Syntax

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

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.

1.3 KiB Raw Blame History