SENDKEYS

Action

Sends one or more keystrokes to the active window as if typed at the keyboard.

 

Syntax

SENDKEYS ("keys")

 

Parameters

Keys

String specifying the keystrokes to send.

Each key is represented by one or more characters. To specify a single keyboard character, use the character itself. For example, to represent the letter A, use "A" for string. To represent more than one character, append each additional character to the one preceding it. To represent the letters A, B, and C, use "ABC" for string. The plus sign (+), caret (^),tilde (~), and parentheses ( ) have special meanings to SendKeys. To specify one of these characters, enclose it within braces ({}). For example, to specify the plus sign, use {+}. To specify brace characters, use {{} and {}}.

To specify characters that aren't displayed when you press a key, such as ENTER or TAB, and keys that represent actions rather than characters, use the codes shown below:

BACKSPACE

{BACKSPACE}

BREAK

{BREAK}

CAPS LOCK

{CAPSLOCK}

DEL

{DEL}

DOWN ARROW

{DOWN}

END

{END}

ENTER

{ENTER}

ESC

{ESC}

HELP

{HELP}

HOME

{HOME}

INS

{INS}

LEFT ARROW

{LEFT}

NUM LOCK

{NUMLOCK}

PAGE DOWN

{PGDN}

PAGE UP

{PGUP}

PRINTSCREEN

{PRTSC}

RIGHT ARROW

{RIGHT}

TAB

{TAB}

UP ARROW

{UP}

F1

{F1}

F2

{F2}

F3

{F3}

F4

{F4}

F5

{F5}

F6

{F6}

F7

{F7}

F8

{F8}

F9

{F9}

F10

{F10}

F11

{F11}

F12

{F12}

F13

{F13}

F14

{F14}

F15

{F15}

F16

{F16}

 

To specify keys combined with any combination of the SHIFT, CTRL, and ALT keys, precede the key code with one or more of the following codes:

SHIFT

+

CTRL

^

ALT

~

 

To specify that any combination of SHIFT, CTRL, and ALT should be held down while several other keys are pressed, enclose the code for those keys in parentheses. For example, to specify to hold down SHIFT while E and C are pressed, use "+(EC)". To specify to hold down SHIFT while E is pressed, followed by C without SHIFT, use "+EC".

To specify repeating keys, use the form {key number}. You must put a space between key and number. For example, {LEFT 42} means press the LEFT ARROW key 42 times; {h 10} means press H 10 times.

Remarks

SendKeys cannot be used to send keystrokes to an application that is not designed to run in Microsoft Windows. Sendkeys also can't send the PRINT SCREEN key {PRTSC} to any application.

Returns

 

0

Keystrokes sent

Error code

Function failed

 

Example

Run( "Notepad.exe" )

Sleep 1

SetFocus( "Untitled – Notepad" )

$ReturnCode = SendKeys("Hello World")

Sleep( 2 )

$ReturnCode = SendKeys("~{F4}Y")