SetStoreCapsLockMode

Whether to restore the state of CapsLock after a Send.

SetStoreCapsLockMode, OnOff

Parameters

OnOff

One of the following values:

On: This is the initial setting for all scripts: CapsLock will be restored to its former value if Send needed to change it temporarily for its operation.

Off: The state of CapsLock is not changed at all. As a result, Send will invert the case of the characters if CapsLock happens to be ON during the operation.

[v1.1.30+]: The decimal values 1 and 0 may be used in place of On and Off, respectively.

Remarks

This means that CapsLock will not always be turned off for Send and ControlSend. Even when it is successfully turned off, it might not get turned back on after the keys are sent.

This command is rarely used because the default behavior is best in most cases.

This setting is ignored by blind mode and (in [v1.1.29+]) text mode; that is, the state of CapsLock is not changed in those cases.

[v1.1.23+]: The built-in variable A_StoreCapsLockMode contains the current setting.

Every newly launched thread (such as a hotkey, custom menu item, or timed subroutine) starts off fresh with the default setting for this command. That default may be changed by using this command in the auto-execute section (top part of the script).

SetCaps/Num/ScrollLockState, Send, ControlSend

Examples

Causes the state of CapsLock not to be changed at all.

SetStoreCapsLockMode, Off