Description:
ADD_KEY_MAP adds a key map or maps to an existing key map list. ADD_KEY_MAP
takes three or more parameters. The first is the name of the key-map-list to
which key-map(s) will be added. The second argument is a string indicating whether
the new key-map(s) will be added as the "first" or "last" map(s) in the list.
When the same key-map is defined in more than one key-map-list, only the first
reference is used. The key map(s) and key-map-list are specified by name and
must exist or an error will be generated.
Syntax:
ADD_KEY_MAP (key-map-list-name, {"first"/"last"}, key-map-name [,...])
Examples:
The following example adds the default key-map to the default key-map-list as
the last map in the list.
ADD_KEY_MAP ("TPU$KEY_MAP_LIST", "last", "TPU$KEY_MAP")
The following creates a key-map, mouse_buttons, stores that map into the
variable mouse_keys, then adds it to the default key-map-list.
mouse_keys = CREATE_KEY_MAP ("mouse_buttons");
ADD_KEY_MAP ("tpu$key_map_list", "first", mouse_keys);
Errors:
TPU$_ILLREQUEST Second argument must be "first" or "last".
TPU$_KEYMAPNTFND Invalid key-map-name.
TPU$_NOKEYMAPLIST Invalid key-map-list-name.
Warning:
TPU$_DUPKEYMAP Keyname redefined within key-map-list.
Related Builtins:
ADD_KEY_MAP