ReleaseKeys Method

Class

AnyWin class.

Action

Releases a set of keys or mouse buttons.

Syntax

window.ReleaseKeys (sKeys [, nDelay])
Variable Description
sKeys The keys or mouse buttons to release. To refer to mouse buttons, use <Button1>, <Button2>, or <Button3> in the string. For the Classic Agent, more than one key is supported. For the Open Agent, only one key is supported. The first key is used and the remaining keys are ignored. STRING.
nDelay Optional: The delay, in seconds, between events. The Open Agent always uses 0 for this value regardless of what is specified in the script. NUMBER.

Notes

ReleaseKeys is a low-level function that most scripts will not call. Instead, scripts generally use the TypeKeys function to enter text.

If you specify nDelay, the value specified there temporarily overrides the global delay set with the OPT_KEYBOARD_DELAY option or set by the Keyboard Event Delay option in the Agent Options dialog.

ReleaseKeys is not supported for native mobile applications.

Valid keystrokes for all browsers except Internet Explorer include:
  • <Alt> (left-side Alt key)
  • <Ctrl> (Left-side Ctrl key)
  • <Shift> (Left-side Shift key)

For all other applications, including web applications on Internet Explorer, see Key names for a list of valid key names.

Example

TextEditor.Document.PressKeys ("<Shift>")
TextEditor.Document.TypeKeys ("abc")
TextEditor.Document.ReleaseKeys ("<Shift>")