Action
Sends a set of keystrokes or mouse button presses to the window when used with the Classic Agent.
Sends a set of keystrokes to the window when used with the Open Agent.
Syntax
window.TypeKeys (sEvents [, nDelay, useClipboard])
Variable
|
Description
|
sEvents
|
The keystrokes to type or mouse buttons to press. Mouse buttons are supported on the Classic Agent only. To specify mouse buttons, use <Button1>, <Button2>, or <Button3> in the string.
STRING.
|
nDelay
|
Optional: The delay between keystrokes (in seconds and fractions of seconds).
NUMBER.
|
useClipboard
|
Optional: Whether
Silk Test Classic uses the new Clipboard method to send text. By default, this is set to FALSE and the original method, which is faster, is used. If you want to send special characters, we recommend setting the parameter to TRUE to use the slower Clipboard method.
BOOLEAN.
|
Notes
- On Windows,
TypeKeys first gives the window input focus before typing into it.
- If you specify
nDelay, that value overrides the value set with the
OPT_KEYBOARD_DELAY option, which you set with
SetOption.
- See
Key Names for a list of key names.
- A key can be followed by a counter, which defines how often the keys should be typed. The counter can be combined with the delay.
- During the delay time, the screen is locked and interaction with the mouse and keyboard is no longer possible.
- When recording with the DOM extension,
TypeKeys ("<Tab>") will not be captured. Since the script refers to object to type in directly, it is not necessary to record this manual Tab. You can manually enter a
TypeKeys ("<Tab>") into your script if you want to; it will just not be recorded.
- When specifying groups of keys, such as
Ctrl+Shift, the Classic Agent only supports minus signs (-) as a delimiter between key names while the Open Agent supports plus and minus signs.
- If the
TypeKeys method does not work as expected, you can try the
SetText method.
Example
//shift-right will be executed 6 times
TextEditor.Document.TypeKeys ("<Shift-Right 6>")
//Shift-Right will be executed 6 times with a delay of 3 seconds before each execution, and uses the Clipboard method
TextEditor.Document.TypeKeys ("<Shift-Right 6>", 3, TRUE)