Send
From AutoItScript Wiki
Send is perhaps one of the most useful functions offered by AutoIt. This function allows you to mimic keyboard inputs. Adapted from AutoIt docs.
Contents |
[edit] Syntax
Send("keys" [, flag])
[edit] Parameters
| Param | Description |
|---|---|
| keys | The sequence of keys to send. |
| flag | [Optional]. Changes how "keys" are processed. |
[edit] Keys
There are a few predefined characters that help with keyboard manipulation.
| Key | Usage | Example |
|---|---|---|
| ! | ALT | Send("!fa"); equivalent to pressing "ALT + f" then "a" |
| + | SHIFT | Send("Hell+o"); outputs "HellO" |
| ^ | CTRL | Send("^s"); save/save as... in most windows applications |
| # | WIN | Send("#rcmd{ENTER}"); opens a command prompt from start menu |
Otherwise, for special keys the following replacements may be used.
| Send Command (if zero flag) | Resulting Keypress |
| {!} | ! |
| {#} | # |
| {+} | + |
| {^} | ^ |
| {{} | { |
| {}} | } |
| {F1} - {F12} | Function keys |
| {SPACE} | SPACE |
| {ENTER} | ENTER key on the main keyboard |
| {ALT} | ALT |
| {BACKSPACE} or {BS} | BACKSPACE |
| {DELETE} or {DEL} | DELETE |
| {TAB} | TAB |
| {UP} | Up arrow |
| {DOWN} | Down arrow |
| {LEFT} | Left arrow |
| {RIGHT} | Right arrow |
| {HOME} | HOME |
| {END} | END |
| {ESCAPE} or {ESC} | ESCAPE |
| {INSERT} or {INS} | INS |
| {PGUP} | PageUp |
| {PGDN} | PageDown |
| {PRINTSCREEN} | Print Screen key |
| {NUMLOCK on} | NUMLOCK (on/off/toggle) |
| {CAPSLOCK off} | CAPSLOCK (on/off/toggle) |
| {SCROLLLOCK toggle} | SCROLLLOCK (on/off/toggle) |
| {BREAK} | for Ctrl+Break processing |
| {PAUSE} | PAUSE |
| {NUMPAD0} - {NUMPAD9} | Numpad digits |
| {NUMPADMULT} | Numpad Multiply |
| {NUMPADADD} | Numpad Add |
| {NUMPADSUB} | Numpad Subtract |
| {NUMPADDIV} | Numpad Divide |
| {NUMPADDOT} | Numpad period |
| {NUMPADENTER} | Enter key on the numpad |
| {APPSKEY} | Windows App key |
| {LWIN} | Left Windows key |
| {RWIN} | Right Windows key |
| {LALT} | Left ALT key |
| {RALT} | Right ALT key |
| {LCTRL} | Left CTRL key |
| {RCTRL} | Right CTRL key |
| {LSHIFT} | Left Shift key |
| {RSHIFT} | Right Shift key |
| {SLEEP} | Computer SLEEP key |
| {ALTDOWN} | Holds the ALT key down until {ALTUP} is sent |
| {SHIFTDOWN} | Holds the SHIFT key down until {SHIFTUP} is sent |
| {CTRLDOWN} | Holds the CTRL key down until {CTRLUP} is sent |
| {LWINDOWN} | Holds the left Windows key down until {LWINUP} is sent |
| {RWINDOWN} | Holds the right Windows key down until {RWINUP} is sent |
| {ASC nnnn} | Send the ALT+nnnn key combination |
| {BROWSER_BACK} | 2000/XP Only: Select the browser "back" button |
| {BROWSER_FORWARD} | 2000/XP Only: Select the browser "forward" button |
| {BROWSER_REFRESH} | 2000/XP Only: Select the browser "refresh" button |
| {BROWSER_STOP} | 2000/XP Only: Select the browser "stop" button |
| {BROWSER_SEARCH} | 2000/XP Only: Select the browser "search" button |
| {BROWSER_FAVORITES} | 2000/XP Only: Select the browser "favorites" button |
| {BROWSER_HOME} | 2000/XP Only: Launch the browser and go to the home page |
| {VOLUME_MUTE} | 2000/XP Only: Mute the volume |
| {VOLUME_DOWN} | 2000/XP Only: Reduce the volume |
| {VOLUME_UP} | 2000/XP Only: Increase the volume |
| {MEDIA_NEXT} | 2000/XP Only: Select next track in media player |
| {MEDIA_PREV} | 2000/XP Only: Select previous track in media player |
| {MEDIA_STOP} | 2000/XP Only: Stop media player |
| {MEDIA_PLAY_PAUSE} | 2000/XP Only: Play/pause media player |
| {LAUNCH_MAIL} | 2000/XP Only: Launch the email application |
| {LAUNCH_MEDIA} | 2000/XP Only: Launch media player |
| {LAUNCH_APP1} | 2000/XP Only: Launch user app1 |
| {LAUNCH_APP2} | 2000/XP Only: Launch user app2 |
Any combination of these may be used for the desired result. For example
Send("^+{F1}A{SHIFTDOWN}a{SHIFTUP}"); output stream Ctrl+Shift+F1 A A
is just like pressing Ctrl + Shift + F1 A Shift + a
[edit] Flags
| Flag | Description |
|---|---|
| 0 | (Default). Text contains special characters like + and ! to indicate SHIFT and ALT key-presses. |
| 1 | Keys are sent raw. |
[edit] Return Value
None.
[edit] Example
Send("^!{DEL}s{ENTER}"); equivalent to Ctrl+Alt+Del Windows shutdown
or
Send("#uu"); equivalent to Windows start menu shutdown
