###Function###
Send

###Description###
Sendet ein oder mehrere sumulierte Tastendrcke an das aktive Fenster.

###Syntax###
Send ( "keys" [, flag] )


###Parameters###
@@ParamTable@@
keys
	Die Folge von Tastendrcken die gesendet werden soll.
flag
	[optional] Kennzeichnet wie "keys" ausgefhrt wird:
	  flag = 0 (Vorgabe), Text beinhaltet spezielle Zeichen, wie + und ! die fr SHIFT (=UMSCHALT) und ALT Tasten stehen.
	  flag = 1, "keys" werden wie angegeben ausgefhrt.
@@End@@


###ReturnValue###
Kein.


###Remarks###
Siehe <a href="..\appendix\SendKeys.htm">Appendix</a> fr einige Tips fr die Verwendung von "Send".  AutoIt kann alle ASCII und erweiterte ASCII Zeichen (0-255) senden. Um UNICODE Zeichen zu senden muss die "ASC" Option benutzt werden und der Code des Zeichens das gesendet werden soll (siehe {ASC} am Ende der untenstehenden Tabelle).

Die "Send" Befehlssyntax ist hnlich der von ScriptIt und dem Visual Basic "SendKeys" Befehl. Die Zeichen werden wie geschrieben gesendet, mit Ausnahme der folgenden Zeichen:

'!'
Dies weist AutoIt an den ALT Tastendruck zu senden, folglich wrde Send("This is text!a") die Tastendrcke "This is text" senden und dann die Tastendrcke "ALT+a".

N.B. Einige Programme sind sehr empfindlich bezglich Grobuchstaben und ALT Taste, z.B. "!A" ist unterschiedlich zu "!a". Der erste Ausdruck bewirkt ALT+SHIFT+A, der zweite ist ALT+a. Im Zweifelsfall benutze Kleinschreibung!

'+'
Dies weist AutoIt an den SHIFT (=UMSCHALT) Tastendruck zu senden, folglich wrde Send("Hell+o") den Text "HellO" senden. Send("!+a") wrde "ALT+SHIFT+a" senden.

'^'
Dies weist AutoIT an den CONTROL (=STRG =STEUERUNG) Tastendruck zu senden, folglich wrde Send("^!a") "CTRL+ALT+a" senden.

Bemerkung: Einige Programme reagieren sehr empfindlich auf Gro-/Kleinschreibung und CTRL Tastendcke, z.B. "^A" ist unterschiedlich zu "^a". Der erste Ausdruck sendet CTRL+SHIFT+A, der zweite sendet CTRL+a.  Im Zweifesfall benutze Kleinschreibung!

'#'
Die hash (=Raute =Doppelkreuz) Taste simuliert das Drcken der Window Taste. Folglich wrde Send("#r") Win+r senden und damit die Run Dialogbox (Aufhren-Dialog) aufrufen.


Man kann "SendCapslockMode" so einstellen, dass die CAPSLOCK (FESTSTELLTASTE) Taste beim start einer "Send" Operation abgeschaltet wird und nach beenden wieder zurckgesetz wird.
Wie auch immer, wenn ein Anwender die SHIFT Taste beim Beginn einer "Send" Funktion gedrckt hlt, knnte der Text in Grobuchstaben gesendet werden.
Eine Vermeidungsmglichkeit ist Send("{SHIFTDOWN}{SHIFTUP}") vor der eigentlichen "Send" Operations zu senden.


Bestimmte spezielle Tastendrcke msssen in gschweiften Klammern gesendet werden:

Bemerkung: Windows erlaubt nicht das senden der "CTRL-ALT-DEL" Tastenkombination!
@@StandardTable@@
<b>Send Befehl (wenn Flag=0)</b>	<b>Resultierende Tastendruck</b>
{!}	!
{#}	#
{+}	+
{^}	^
{{}	{
{}}	}
{SPACE}	Leertaste
{ENTER}	Eingabetast auf der Haupttastatur
{ALT}	ALT
{BACKSPACE} or {BS}	Rcktaste
{DELETE} or {DEL}	Entfernen (Entf)
{UP}	Nach-Oben-Taste
{DOWN}	Nach-Unten-Taste
{LEFT}	Nach-Links-Taste
{RIGHT}	Nach-Rechts-Taste
{HOME}	POS1
{END}	ENDE
{ESCAPE} or {ESC}	ESCAPE
{INSERT} or {INS}	EINFGEN (EINFG)
{PGUP}	Bild-Auf
{PGDN}	Bild-Ab
{F1} - {F12}	Funktions Tasten
{TAB}	TABULATOR
{PRINTSCREEN}	Drucken
{LWIN}	Linke Windows Taste
{RWIN}	Rechte Windows Taste
{NUMLOCK on}	Numerisches Tastenfeld (an/aus/wechseln)=(on/off/toggle)
{CAPSLOCK off}	FESTSTELLTASTE (an/aus/wechseln)=(on/off/toggle)
{SCROLLLOCK toggle}	ROLLEN (an/aus/wechseln)=(on/off/toggle)
{CTRLBREAK}	Ctrl+Break = STRG+UNTERBRECHUNG
{PAUSE}	PAUSE

{NUMPAD0} - {NUMPAD9}	Numpad Ziffern (Numpad = Numerisches Tastenfeld)
{NUMPADMULT}	Numpad Multiplizieren
{NUMPADADD}	Numpad Addieren
{NUMPADSUB}	Numpad Subtrahieren
{NUMPADDIV}	Numpad Dividieren
{NUMPADDOT}	Numpad Punkt
{NUMPADENTER}	Numpad Eingabe Taste
{APPSKEY}	Windows Programm Taste
{LALT}	Links ALT Taste
{RALT}	Rechts ALT Taste
{LCTRL}	Links CTRL Taste
{RCTRL}	Rechts CTRL Taste
{LSHIFT}	Linke Shift Taste
{RSHIFT}	Rechte Shift Taste
{SLEEP}	Computer PAUSE Taste
{ALTDOWN}	Hlt die ALT Taste gedrckt bis {ALTUP} gesendet wird
{SHIFTDOWN}	Hlt die SHIFT Taste gedrckt bis {SHIFTUP} gesendet wird
{CTRLDOWN}	Hlt die CTRL Taste gedrckt bis {CTRLUP} gesendet wird
{LWINDOWN}	Hlt die linke Windows Taste gedrckt bis {LWINUP} gesendet wird
{RWINDOWN}	Hlt die rechte Windows Taste gedrckt bis {RWINUP} gesendet wird
{ASC nnnn}	Sendet die ALT+nnnn Tastenkombination
{BROWSER_BACK}	Nur 2000/XP: Whlt den Browser "Zurck" Button
{BROWSER_FORWARD}	Nur 2000/XP: Whlt den Browser "Vorwrts" Button
{BROWSER_REFRESH}	Nur 2000/XP: Whlt den Browser "Aktualisieren" Button
{BROWSER_STOP}	Nur 2000/XP: Whlt den Browser "Stop" Button
{BROWSER_SEARCH}	Nur 2000/XP: Whlt den Browser "Suche" Button
{BROWSER_FAVORITES}	Nur 2000/XP: Whlt den Browser "Favoriten" Button
{BROWSER_HOME}	Nur 2000/XP: Startet den Browser und geht zur Startseite
{VOLUME_MUTE}	Nur 2000/XP: Stellt Lautsprecher auf Stumm
{VOLUME_DOWN}	Nur 2000/XP: Reduziert die Lautstrke
{VOLUME_UP}	Nur 2000/XP: Steigert die Lautstrke
{MEDIA_NEXT}	Nur 2000/XP: Whlt den nchsten Track im Media Player
{MEDIA_PREV}	Nur 2000/XP: Whlt den vorhergehenden Track im Media Player
{MEDIA_STOP}	Nur 2000/XP: Stoppt Media Player
{MEDIA_PLAY_PAUSE}	Nur 2000/XP: Wiedergabepause Media player
{LAUNCH_MAIL}	Nur 2000/XP: Startet die Standard email Anwaendung
{LAUNCH_MEDIA}	Nur 2000/XP: Startet den Media Player
{LAUNCH_APP1}	Nur 2000/XP: Startet Anwender Programm 1
{LAUNCH_APP2}	Nur 2000/XP: Startet Anwender Programm 2
@@End@@

Um den ASCII Wert A zu senden, der durch drcken von ALT+065 auf dem numerischen Tastenfeld erzeugt wird, benutze
    Send("{ASC 065}")

Bei einem 2 ziffrigem ASCII Code muss eine 0 vorangestellt werden.

Um UNICODE Zeichen zu senden muss der Zeichencode eingegeben werdeb. Z.B. wird so ein chinesisches Zeichen gesendet
    Send("{ASC 2709}")


Einzelne Tastendrcke knnen auch wiederholt werden, z.B.
    Send("{DEL 4}")    ;Drckt die ENTF Taste 4 mal
    Send("{S 30}")      ;Sendet 30 'S' Zeichen
    Send("+{TAB 4})   ;Drckt SHIFT+TAB 4 mal

Um eine Taste gedrckt zu halten (Allgemein nur brauchbar fr Spiele)
    Send("{a down}")    ;Hlt die A Taste gedrckt
    Send("{a up}")        ;Loslassen der A Taste

So wird der Status fr Capslock, Numlock und Scrolllock gesetzt.
    Send("{NumLock on}")        ;Schaltet NUMLock ein
    Send("{CapsLock off}")      ;Schaltet die CapsLock Taste aus
    Send("{ScrollLock toggle}") ;Wechselt den Status von ScrollLock

Soll eine Variable fr die Anzahl von Wiederholungen genutzt werden, dann versuche
    $n = 4
    Send("+{TAB " & $n & "}")

Soll der ASCII Wert A 4 mal gesendet werden, dann versuche
    $x = Chr(65)
    Send("{" & $x & " 4}")

Die meisten Notebooks haben auf der Tastatur eine spezielle Fn Taste.  Diese Taste kann nicht simuliert werden.

Beachte, wird der Flag Parameter auf 1 gesetzt, werden keine der zuvor angefhrten "speziellen" Tastendrcke gesendet.  Das ist praktisch wenn einiger Text, kopiert von einer Variablen, genauso wie geschrieben gesendet werden soll.


Z.B., ffne Ordneroptionen (Explorer -> Extras -> ...) und versuche folgendes:
@@StandardTable@@
Send("{TAB}")	Navigiere zum nchsten Control (Button, Checkbox, usw.) 
Send("+{TAB}")	Navigiere zum vorhergehenden Control. 
Send("^{TAB}")	Navigiere zum nchsten WindowTab (in einem Dialog mit Tabs) 
Send("^+{TAB}")	Navigiere zum vorhergehenden WindowTab. 
Send("{SPACE}")	Kann benutzt werden um eine Checkbox (Kontrollkstchen) zu makieren oder ein Button anzuklicken. 
Send("{+}")	Aktiviert/markiert blicherweise eine Checkbox (wenn es wirklich eine Checkbox ist.) 
Send("{-}")	Deaktiviert eine Checkbox. 
Send("{NumPadMult}")	Expandiert rekursiv Verzeichnisse in einem SysTreeView32.
@@End@@

Benutze Alt-key Kombinationen um auf Menpunkte zuzugreifen.  Also, ffne Notepad und versuche folgendes:
Send("!d") Sendet Alt+d, die Zugriffstaste auf Notepad's Datei Men.

@@StandardTable@@
Send("{DOWN}")	Geht runter im Menu. 
Send("{UP}")	Geht rauf im Menu. 
Send("{LEFT}")	Geht links zu einem neuen Menu oder expandiert ein Untermen. 
Send("{RIGHT}")	Geht rechts zu einem neuen Menu oder kollapsed ein Untermen. 
@@End@@
Siehe Windows' Help--drcke Win+F1--fr eine komplette Liste von Tastatur "shortcuts", wenn du die Bedeutung von Alt+F4, PrintScreen, Ctrl+C, .... nicht kennst.



###Related###
SendAttachmode (Option), SendKeyDelay (Option), SendKeyDownDelay (Option), ControlSend


###Example###
@@IncludeExample@@
