Send / SendRaw / SendInput / SendPlay / SendEvent

Sendet simulierte Tastendrücke und Mausklicks an das aktive Fenster.

Send Tasten
SendRaw Tasten
SendInput Tasten
SendPlay Tasten
SendEvent Tasten

Parameter

Tasten

Eine Sequenz von Tasten, die gesendet werden sollen. Das Komma vor dem ersten Parameter ist optional (wie bei anderen Befehlen auch).

Standardmäßig (also wenn weder SendRaw noch der Raw-Modus oder Text-Modus verwendet wird) haben die Zeichen ^+!#{} eine besondere Bedeutung. Die Zeichen ^+!# repräsentieren die Modifikatortasten Strg, Umschalt, Alt und Win. Sie wirken sich nur auf die jeweils nächste Taste aus. Um die entsprechende Modifikatortaste separat zu senden, umschließen Sie den Tastennamen mit geschweiften Klammern. Um die Taste nur gedrückt zu halten oder loszulassen, fügen Sie nach dem Tastennamen das Wort "down" oder "up" an, wie unten gezeigt.

Symbol	Taste	Drücken	Loslassen	Beispiele
^	{Ctrl}	{Ctrl down}	{Ctrl up}	Send ^{Home} drückt Strg+Pos1
+	{Shift}	{Shift down}	{Shift up}	Send +abC sendet den Text "AbC" Send !+a drückt Alt+Umschalt+A
!	{Alt}	{Alt down}	{Alt up}	Send !a drückt Alt+A
#	{LWin} {RWin}	{LWin down} {RWin down}	{LWin up} {RWin up}	Send #e hält Win gedrückt und drückt E

Hinweis: Da durch Senden von Umschalt Großbuchstaben erzeugt werden, hat A in einigen Programmen einen anderen Effekt als a. Zum Beispiel bewirkt !A, dass Alt+Umschalt+A gedrückt wird, und !a, dass Alt+A gedrückt wird. Im Zweifelsfall immer Kleinbuchstaben verwenden.

Die Zeichen {} werden verwendet, um Tastennamen und andere Optionen zu umschließen und um die spezielle Bedeutung einiger Zeichen außer Kraft zu setzen. Zum Beispiel wird {Tab} Tab drücken und {!} ein normales Ausrufezeichen senden.

[v1.1.27+]: Wenn ein reiner ASCII-Buchstabe (a-z oder A-Z) mit geschweiften Klammern umschlossen wird, ist Send gezwungen, den Buchstaben als virtuellen Tastencode zu senden, egal ob das Zeichen in der aktuellen Tastaturbelegung existiert oder nicht. Mit anderen Worten, Send a erzeugt den Buchstaben "a", während Send {a} vielleicht je nach Tastaturbelegung den Buchstaben "a" erzeugt. Einzelheiten finden Sie unter Bemerkungen.

Send-Varianten

Send: Standardmäßig ist Send synonym mit SendEvent, kann aber via SendMode synonym mit SendInput oder SendPlay gemacht werden.

SendRaw: Ähnlich wie Send, außer dass alle Zeichen in Tasten als direkt geschriebener Text interpretiert und gesendet werden. Weitere Informationen finden Sie unter Raw-Modus.

SendInput und SendPlay [v1.0.43+]: SendInput und SendPlay verwenden die gleiche Syntax wie Send, sind aber in der Regel schneller und zuverlässiger. Außerdem puffern sie alle physischen Tastatur- und Mausaktionen des Benutzers während des Sendens, um zu verhindern, dass die Tastendrücke des Benutzers mit den Gesendeten vermischt werden. SendMode kann verwendet werden, um Send synonym mit SendInput oder SendPlay zu machen. Weitere Informationen zu den einzelnen Modi finden Sie unter SendInput und SendPlay weiter unten.

SendEvent [v1.0.43+]: SendEvent sendet Tastendrücke auf dieselbe Weise wie der pre-1.0.43 Send-Befehl. Die Geschwindigkeit, mit der die Tastendrücke gesendet werden, wird durch SetKeyDelay beeinflusst.

Spezielle Modi

Die folgenden Modi beeinflussen die Interpretation der Zeichen in Tasten oder das Verhalten von Befehlen, die Tasten senden, wie z.B. Send, SendInput, SendPlay, SendEvent und ControlSend. Diese Modi müssen in Form von {x} in Tasten angegeben werden, wobei x entweder Raw, Text oder Blind ist. Zum Beispiel {Raw}.

Raw-Modus

Der Raw-Modus kann mit {Raw}, SendRaw oder ControlSendRaw aktiviert werden und interpretiert alle nachfolgenden Zeichen einschließlich ^+!#{} als direkt geschriebenen Text, anstatt {Enter} in Enter, ^c in Strg+C usw. zu übersetzen. Zum Beispiel bewirken sowohl Send {Raw}{Tab} als auch SendRaw {Tab}, dass {Tab} statt Tab gesendet wird.

Der Raw-Modus hat keinen Einfluss auf die Interpretation von Escapesequenzen, Variablenreferenzen und Ausdrücken. Zum Beispiel bewirkt SendRaw, ``100`%, dass die Zeichenkette `100% gesendet wird. Bei der Verwendung von ControlSend müssen direkt geschriebene Kommas zusätzlich mit einem Escapezeichen versehen werden (`,).

Text-Modus [v1.1.27+]

Der Text-Modus kann mit {Text} aktiviert werden und bewirkt dasselbe wie der Raw-Modus, allerdings ohne den Versuch, Zeichen (außer `r, `n, `t und `b) in Tastencodes umzuwandeln; stattdessen wird für alle übrigen Zeichen die Fallback-Methode angewendet. Dies verbessert die Zuverlässigkeit von SendEvent, SendInput und ControlSend, da die Zeichen kaum noch vom korrekten Modifikatorstatus abhängig sind. Dieser Modus kann mit dem Blind-Modus kombiniert werden, um das Loslassen von Modifikatortasten zu vermeiden: Send {Blind}{Text}Ihr Text. Einige Anwendungen erfordern jedoch, dass Modifikatortasten losgelassen werden.

`n, `r und `r`n werden in einen einzelnen Enter-Tastendruck übersetzt, im Gegensatz zum Standardverhalten und dem Raw-Modus, wo `r`n in zwei Enter-Tastendrücke übersetzt wird. `t wird in Tab und `b in Backspace übersetzt, während alle anderen Zeichen ohne Übersetzung gesendet werden.

[v1.1.29+]: Der Text-Modus ignoriert, wie der Blind-Modus auch, SetStoreCapsLockMode (d.h. der Status der Feststell-Taste wird nicht geändert) und wartet nicht auf das Loslassen von Win. Der Grund dafür ist, dass der Text-Modus in der Regel nicht vom Status der Feststell-Taste abhängig ist und nicht den systeminternen Win+L-Hotkey auslösen kann. Dies gilt jedoch nur, wenn Tasten mit {Text} oder {Blind}{Text} beginnt.

Blind-Modus

Der Blind-Modus kann mit {Blind} aktiviert werden und gibt dem Skript mehr Kontrolle, indem eine Reihe von Dingen deaktiviert werden, die normalerweise automatisch vorgenommen werden, damit die Dinge wie erwartet funktionieren. {Blind} muss das erste Element in der Zeichenkette sein, um den Blind-Modus zu aktivieren. Dieser Modus hat die folgenden Auswirkungen:

• Der Blind-Modus verhindert, dass nach unten gedrückte Modifikatortasten (Alt, Strg, Umschalt und Win) wieder automatisch losgelassen werden. Zum Beispiel würde der Hotkey +s::Send {Blind}abc ABC statt abc senden, wenn der Benutzer Umschalt gedrückt hält.
• Modifikatortasten werden auf andere Weise wiederhergestellt, damit ein Send die Modifikatoren eines Hotkeys ausschalten kann, auch dann, wenn der Benutzer sie physisch noch gedrückt hält. Zum Beispiel bewirkt ^space::Send {Ctrl up}, dass Strg automatisch wieder nach unten gedrückt wird, wenn der Benutzer Strg noch physisch gedrückt hält, während ^space::Send {Blind}{Ctrl up} zulässt, dass Strg logisch oben ist, obwohl es physisch unten ist.
• SetStoreCapslockMode wird ignoriert, d.h. der Status von Feststell bleibt unverändert.
• Menü-Maskierung ist deaktiviert. Das bedeutet, dass Send die zusätzlichen Tastendrücke ignoriert, die sonst gesendet werden würden, um Folgendes zu verhindern: 1) Öffnen des Startmenüs beim Drücken einer Win-Taste (LWin/RWin); 2) Aktivierung der Menüleiste beim Drücken einer Alt-Taste. Der Blind-Modus verhindert jedoch nicht die Maskierung durch den Tastatur-Hook nach Aktivierung einer Hook-Taste.
• Send wartet nicht auf das Loslassen von Win, auch dann nicht, wenn der Text einen L-Tastendruck enthält. Dies geschieht normalerweise, um zu verhindern, dass Send den System-Hotkey "Arbeitsplatz sperren" (Win+L) auslöst. Weitere Informationen finden Sie unter Hotkeys.

AutoHotkey verwendet automatisch den Blind-Modus beim Neubelegen einer Taste. Zum Beispiel würde die Neubelegung a::b Folgendes erzeugen: 1) "b", wenn "a" eingegeben wird; 2) großes "B", wenn ein großes "A" eingegeben wird; und 3) Strg+B, wenn Strg+A eingegeben wird.

{Blind} wird nicht von SendRaw oder ControlSendRaw unterstützt; verwenden Sie stattdessen {Blind}{Raw}.

Der Blind-Modus wird von SendPlay nur teilweise unterstützt, insbesondere wenn es sich um die Modifikatortasten (Strg, Alt, Umschalt und Win) handelt.

Tastennamen

Die folgende Tabelle listet alle speziellen Tasten auf, die gesendet werden können (jeder Tastenname muss mit geschweiften Klammern umschlossen werden):

Mehrfaches oder haltendes Drücken einer Taste

Mehrfaches Drücken: Geben Sie in geschweiften Klammern den Namen der Taste und die Anzahl der Wiederholungen an. Zum Beispiel:

Send {DEL 4}  ; Drückt viermal die ENTF-Taste.
Send {S 30}   ; Sendet 30-mal ein großes S.
Send +{TAB 4}  ; Drückt viermal UMSCHALT+TAB.

Halten oder Loslassen: Geben Sie in geschweiften Klammern den Namen der Taste und das Wort Down oder Up an. Zum Beispiel:

Send {b down}{b up}
Send {TAB down}{TAB up}
Send {Up down}  ; Drückt die NACH-OBEN-Taste nach unten.
Sleep 1000  ; Hält sie eine Sekunde lang gedrückt.
Send {Up up}  ; Lässt die NACH-OBEN-Taste los.

Wenn eine Taste mit der obigen Methode gedrückt gehalten wird, wird sie nicht automatisch wiederholt, wie es beim physischen Gedrückthalten der Fall wäre (da Autowiederholung ein Treiber/Hardware-Feature ist). Es kann jedoch eine Schleife verwendet werden, um eine Autowiederholung zu simulieren. Das folgende Beispiel sendet 20 Tabulatortastendrücke:

Loop 20
{
    Send {Tab down}  ; Autowiederholung besteht aus fortlaufenden Down-Ereignissen (ohne Up-Ereignisse).
    Sleep 30  ; Verzögerung in Millisekunden zwischen den Tastendrücken (oder SetKeyDelay verwenden).
}
Send {Tab up}  ; Taste loslassen.

Standardmäßig lässt Send eine Modifikatortaste (Strg, Umschalt, Alt und Win) nicht automatisch los, wenn diese Modifikatortaste durch Senden "nach unten gedrückt" wurde. Zum Beispiel kann sich Send a ähnlich wie Send {Blind}{Ctrl up}a{Ctrl down} verhalten, wenn der Benutzer Strg physisch gedrückt hält, während Send {Ctrl Down} gefolgt von Send a bewirkt, dass Strg+A erzeugt wird. DownTemp und DownR können verwendet werden, um dieses Verhalten zu überschreiben. DownTemp und DownR haben die gleiche Wirkung wie Down, außer bei den Modifikatortasten (Strg, Umschalt, Alt und Win).

DownTemp teilt nachfolgenden Sends mit, dass die Taste nicht dauerhaft unten ist und jederzeit losgelassen werden kann, wenn ein Tastendruck dies erfordert. Zum Beispiel würde Send {Control DownTemp}, später gefolgt von Send a, A erzeugen, nicht Strg+A. Jede Verwendung von Send kann dazu führen, dass der Modifikator dauerhaft losgelassen wird, daher ist DownTemp nicht unbedingt für die Neubelegung von Modifikatortasten geeignet.

[v1.1.27+]: DownR (das "R" steht für Remapping bzw. Neubelegung, was dessen Hauptzweck darstellt) teilt nachfolgenden Sends mit, dass die Taste, wenn sie automatisch losgelassen wird, nach Abschluss des Sends erneut gedrückt werden soll. Zum Beispiel würde Send {Control DownR}, später gefolgt von Send a, A erzeugen, nicht Strg+A, aber Strg für eventuelle Tastaturkurzbefehle gedrückt lassen. Mit anderen Worten, DownR hat denselben Effekt wie, als würde man die Taste physisch drücken.

Wenn ein Zeichen nicht zu einer virtuellen Taste in der aktuellen Tastaturbelegung gehört, kann es weder "gedrückt" noch "losgelassen" werden. Zum Beispiel hat Send {µ up} bei die meisten Belegungen keinen Effekt, während Send {µ down} äquivalent zu Send µ ist.

Allgemeine Bemerkungen

Zeichen vs. Tasten: Standardmäßig werden Zeichen gesendet, indem sie zunächst in Tastendrücke übersetzt werden. Wenn diese Übersetzung nicht möglich ist (also wenn die aktuelle Tastaturbelegung keine Taste oder Tastenkombination enthält, die das Zeichen erzeugen würde), wird das Zeichen mit einer der folgenden Fallback-Methoden gesendet:

• SendEvent und SendInput verwenden SendInput() mit dem KEYEVENTF_UNICODE-Flag. [v1.1.27+]: ANSI-Builds von AutoHotkey wandeln das Zeichen in Unicode um, bevor es gesendet wird. Vor v1.1.27 verwendeten ANSI-Builds die Alt+nnnnn-Methode.
• SendPlay verwendet die Alt+nnnnn-Methode, die nur Unicode erzeugt, wenn es von der Zielanwendung unterstützt wird.
• ControlSend postet eine WM_CHAR-Meldung.

Hinweis: Zeichen, die mit einer der oben genannten Methoden gesendet werden, lösen in der Regel keine Tastaturkurzbefehle oder Hotkeys aus.

[v1.1.27+]: Jedes Zeichen im Bereich von a-z oder A-Z (reine ASCII-Buchstaben), das nicht in der aktuellen Tastaturbelegung existiert, kann entweder als Zeichen oder als entsprechender virtueller Tastencode (vk41-vk5A) gesendet werden:

• Wenn ein reiner Buchstabe (also ohne Modifikatoren oder geschweifte Klammern) gesendet wird oder wenn der Raw-Modus aktiv ist, wird der Buchstabe als Zeichen gesendet. Zum Beispiel sendet Send {Raw}Regards den erwarteten Text, selbst wenn das Drücken von R (vk52) ein anderes Zeichen erzeugt (z.B. К in der russischen Belegung). {Raw} kann in diesem Fall weggelassen werden, es sei denn, eine Modifikatortaste wurde durch ein vorheriges Send wirksam.
• Wenn eine oder mehrere Modifikatortasten durch den Send-Befehl wirksam wurden oder wenn der Buchstabe in geschweiften Klammern gesetzt ist, wird der Buchstabe als Tastencode gesendet (mit Umschalt modifiziert, wenn es sich um einen Großbuchstaben handelt). Dadurch kann das Skript auf einfache Weise die vordefinierten Tastaturkurzbefehle aktivieren. Zum Beispiel würden ^c und {Ctrl down}c{Ctrl up} den vordefinierten Tastaturkurzbefehl Strg+C aktivieren, während {c} äquivalent zu {vk43} ist.

Wenn der Buchstabe in der aktuellen Tastaturbelegung existiert, wird er als Tastencode gesendet, den die Belegung mit diesem Buchstaben assoziiert (es sei denn, der Text-Modus wird verwendet, dann wird das Zeichen auf andere Weise gesendet). Mit anderen Worten, der obige Abschnitt ist nur für nicht-lateinbasierte Belegungen relevant, wie z.B. Russisch.

Modifikatorstatus: Wenn Send den Status der Modifikatortasten Win oder Alt ändern muss (z.B. wenn der Benutzer eine dieser Tasten gedrückt hält), kann es zusätzliche Tastendrücke injizieren (standardmäßig Strg), um zu verhindern, dass das Startmenü oder das Fenstermenü angezeigt wird. Weitere Informationen finden Sie unter #MenuMaskKey.

BlockInput vs. SendInput/SendPlay: Obwohl der BlockInput-Befehl verhindern kann, dass physische Tastendrücke den Fluss von simulierten Tastendrücken unterbrechen, ist es oft besser, SendInput oder SendPlay zu verwenden, damit Tastendrücke und Mausklicks nicht unterbrochen werden können. SendInput/Play verhindert im Gegensatz zu BlockInput, dass die Tastendrücke des Benutzers während des Sendens verworfen werden; stattdessen werden solche Tastendrücke gepuffert und danach gesendet.

Beim Senden vieler Tastendrücke kann ein Fortsetzungsbereich verwendet werden, um die Übersichtlichkeit und Wartbarkeit des Skripts zu verbessern.

Da das Betriebssystem das Simulieren von Strg+Alt+Entf nicht erlaubt, wird so etwas wie Send ^!{Delete} nicht funktionieren.

Send hat möglicherweise keine Wirkung in Windows Vista oder höher, wenn das aktive Fenster mit Adminrechten ausgeführt wird und das Skript nicht. Dies ist auf einen Sicherheitsmechanismus namens Benutzeroberflächen-Rechteisolierung (engl. User Interface Privilege Isolation, kurz UIPI) zurückzuführen.

SendInput [v1.0.43+]

SendInput ist in der Regel die bevorzugte Methode zum Senden von Tastendrücken und Mausklicks, da sie schneller und zuverlässiger ist als die anderen Methoden. In den meisten Fällen ist SendInput nahezu verzögerungsfrei, sogar wenn lange Zeichenketten gesendet werden. Durch diese Schnelligkeit ist SendInput auch zuverlässiger, da das Risiko verringert wird, dass unerwartet ein anderes Fenster erscheint und die Tastendrücke abfängt. Die Zuverlässigkeit wird noch weiter verbessert durch die Tatsache, dass alles, was der Benutzer während eines SendInputs eingibt, bis zu dessen Abschluss nach hinten verschoben wird.

Im Gegensatz zu den anderen Send-Modi ist SendInput auf ca. 5000 Zeichen begrenzt (dies kann je nach Systemversion und Performanzeinstellungen variieren). Zeichen und Ereignisse oberhalb dieser Grenze werden nicht gesendet.

Hinweis: SendInput ignoriert SetKeyDelay, da das Betriebssystem in diesem Modus keine Verzögerung unterstützt. Wenn SendInput jedoch wegen der unten beschriebenen Bedingungen auf SendEvent zurückfällt, verwendet es SetKeyDelay -1, 0 (es sei denn, die Tastenverzögerung von SendEvent ist -1, -1, dann wird -1, -1 verwendet). Wenn SendInput auf SendPlay zurückfällt, verwendet es die Tastenverzögerung von SendPlay.

Wenn ein anderes Skript als das Skript, das SendInput ausführt, einen Low-Level-Tastatur-Hook installiert hat, fällt SendInput automatisch auf SendEvent zurück (oder auf SendPlay, wenn SendMode InputThenPlay aktiv ist). Dies geschieht, weil das Vorhandensein eines externen Hooks alle Vorteile von SendInput außer Kraft setzt, wodurch es sowohl SendPlay als auch SendEvent unterlegen ist. Da SendInput jedoch nicht in der Lage ist, einen Low-Level-Hook in anderen Programmen als [AutoHotkey v1.0.43+] zu erkennen, fällt es in solchen Fällen nicht zurück, wodurch es weniger zuverlässig ist als SendPlay/Event.

Wenn SendInput Mausklicks mit Mitteln wie {Click} sendet, während CoordMode Mouse, Relative aktiv ist (die Standardeinstellung), wird jeder Klick relativ zum Fenster sein, das zu Beginn des Sendens aktiv war. Wenn SendInput also absichtlich ein anderes Fenster aktiviert (z.B. mit ALT+TAB), werden die Koordinaten der nachfolgenden Klicks innerhalb desselben Befehls falsch sein, da sie immer noch relativ zum alten statt zum neuen Fenster sind.

SendPlay [v1.0.43+]

Warnung: SendPlay funktioniert möglicherweise nicht, wenn die Benutzerkontensteuerung (engl. User Account Control, kurz UAC) aktiviert ist, auch wenn das Skript als Administrator ausgeführt wird. Weitere Informationen finden Sie in der FAQ.

SendPlay hat gegenüber den anderen Modi den großen Vorteil, dass es Tastendrücke und Mausklicks in einer breiteren Palette von Videospielen "wiedergeben" kann. Zum Beispiel könnte ein bestimmtes Videospiel nur Hotstrings mit der SendPlay-Option akzeptieren.

Von den drei Send-Modi ist SendPlay der ungewöhnlichste, da er an sich keine Tastendrücke und Mausklicks simuliert. Stattdessen erstellt dieser Modus eine Sequenz von Ereignissen (Meldungen), die direkt in das aktive Fenster einfließen (ähnlich wie ControlSend, aber auf einer niedrigeren Ebene). Folglich löst SendPlay keine Hotkeys oder Hotstrings aus.

Wie bei SendInput werden die Tastendrücke von SendPlay nicht mit den Tastendrücken des Benutzers vermischt. Wenn der Benutzer also während eines SendPlays etwas eingibt, werden diese Tastendrücke bis zu dessen Abschluss nach hinten verschoben.

SendPlay ist deutlich langsamer als SendInput, aber schneller als der traditionelle SendEvent-Modus (selbst bei einer Tastenverzögerung von -1).

Beide Win-Tasten (LWin und RWin) werden während eines SendPlays automatisch blockiert, wenn der Tastatur-Hook installiert ist. Dies verhindert, dass das Startmenü angezeigt wird, wenn der Benutzer während des Sendens versehentlich Win drückt. Alle anderen Tasten müssen hingegen nicht blockiert werden, da das Betriebssystem diese automatisch bis zum Abschluss von SendPlay nach hinten verschiebt (via Pufferung).

SendPlay verwendet nicht die Standardeinstellungen von SetKeyDelay und SetMouseDelay. Stattdessen verwendet es standardmäßig überhaupt keine Verzögerung, was aber wie folgt geändert werden kann:

SetKeyDelay, 0, 10, Play  ; Beachten Sie, dass sowohl 0 als auch -1 im SendPlay-Modus dasselbe sind.
SetMouseDelay, 10, Play

SendPlay kann Feststell, Num oder Rollen weder ein- noch ausschalten. Ebenso ist es nicht in der Lage, den von GetKeyState gesehenen Status einer Taste zu ändern, es sei denn, die Tastendrücke werden an eines der eigenen Fenster des Skripts gesendet. Selbst dann können Änderungen an den linken/rechten Modifikatortasten (z.B. RControl) nur über ihre neutralen Gegenstücke (z.B. Control) erkannt werden. Darüber hinaus gelten für SendPlay noch weitere Einschränkungen, die auf der SendMode-Seite beschrieben sind.

Im Gegensatz zu SendInput und SendEvent kann ein SendPlay durch Drücken von Strg+Alt+Entf oder Strg+Esc unterbrochen werden. In diesem Fall werden die restlichen Tastendrücke nicht gesendet, aber das Skript wird weiter ausgeführt, als wäre SendPlay normal abgeschlossen worden.

Obwohl SendPlay LWin- und RWin-Ereignisse senden kann, werden diese direkt an das aktive Fenster gesendet, anstatt ihre native Systemfunktion auszuführen. Um das zu umgehen, verwenden Sie SendEvent. Zum Beispiel bewirkt SendEvent #r, dass das Ausführen-Dialogfenster des Startmenüs angezeigt wird.

Siehe auch

SendMode, SetKeyDelay, SetStoreCapsLockMode, Escapesequenzen (z.B. `%), ControlSend, BlockInput, Hotstrings, WinActivate

Beispiele

Send Mit freundlichen Grüßen,{enter}Max Mustermann

Send !ds

Send {End}+{Left 4}

SendInput {Raw}Eine lange Sequenz von Rohzeichen, die mit der schnellsten Methode gesendet wurden.

MeineTaste := "Shift"
Send % "{" MeineTaste " down}"  ; Hält die Umschalttaste gedrückt.