Zum Hauptinhalt springen

Benannte Konstanten

Ein Parameter einer integrierten Funktion mit einer festen Auswahl an Möglichkeiten nimmt einen Integer aus einem dieser Namespaces an. Die Namen werden beim Kompilieren des Skripts durch ihre Zahlen ersetzt, kosten zur Laufzeit also nichts, und der Editor vervollständigt sie, nachdem Sie den Namespace und einen Punkt eingegeben haben, und zeigt dabei den Wert und die Bedeutung jedes Namens. Bei ihnen wird die Groß-/Kleinschreibung beachtet, und ein falsch geschriebener Name ist ein Kompilierfehler. Die Zahl selbst funktioniert ebenfalls (VirtualKey.A ist 65 ist 0x41), aber der Name sagt, was gemeint ist. Ein Schritte-Feld, das eine ganze Zahl annimmt, nimmt dieselben Namen an.

NamespaceMember = WertVerwendet von
MouseButtonLeft=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6MouseClick, MouseButtonDown/Up, MouseDoubleClick, MouseIsButtonDown; außerdem das, was ContextGetStrokeButton zurückgibt (-1, wenn es keinen Tastenkontext gibt oder die Geste mit der Tastatur-Zeichentaste gezeichnet wurde). Primary ist die Taste, die Windows als Linksklick behandelt, und Secondary die, die es als Rechtsklick behandelt, gemäß der Windows-Einstellung „Primäre Maustaste“; verwenden Sie sie daher für einen gewöhnlichen Klick oder Rechtsklick. Left und Right sind die physischen Tasten: Sind primäre und sekundäre Taste in den Mauseinstellungen von Windows vertauscht, ist ein Klick mit MouseButton.Left die physische linke Taste, die Windows als Rechtsklick behandelt. ContextGetStrokeButton meldet die Taste nach dem Tausch als Primary oder Secondary, daher meldet eine Geste mit der rechten Taste Secondary, gleich welche physische Taste sie gezeichnet hat, und die Übergabe des Werts an MouseClick drückt genau diese Taste. Aufgezeichnete Makros verwenden Primary und Secondary.
FileNotifyFileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100filterMask von FolderWatchCreate. Das sind Bitflags; kombinieren Sie sie daher mit |.
AudioEndpointPlayback=0 Capture=1 Communications=2die Multimedia*-Funktionen für Lautstärke und Stummschaltung
WindowStyleNormal=0 Minimized=1 Maximized=2 Hidden=3ShellRunProgram
ShellVerbOpen=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6verb von ShellRunProgram, das auch jedes andere Verb als Text akzeptiert
LocationTopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8location von UIShowDisplayMessage, das auch einen Bildschirmpunkt als Text "x,y" akzeptiert
TextAlignLeft=0 Center=1 Right=2UIShowDisplayMessage/UIUpdateDisplayMessage
LockResultAcquired=0 TimedOut=1 Pinned=2zurückgegeben von UtilityLockAcquire/UtilityLockAcquirePinned
LockStateFree=0 HeldByMe=1 HeldByOther=2 Pinned=3zurückgegeben von UtilityLockGetState
SerialParityNone=0 Odd=1 Even=2 Mark=3 Space=4SerialOpenPort, SerialMonitorCreate
SerialStopBitsOne=0 OnePointFive=1 Two=2SerialOpenPort, SerialMonitorCreate
DateTimeStyleShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6DateTimeFormat. Alle außer FileStamp folgen den Windows-Regionseinstellungen des Benutzers, im Kalender dieser Region; FileStamp hat immer die Form 20261001-140509, die sich nach Zeit sortieren lässt und in einem Dateinamen sicher ist.
DateTimePartYear=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6DateTimeGetPart. Gregorianisch, Ortszeit. Weekday folgt ISO: 1 ist Montag, 7 ist Sonntag.
VirtualKeydie Win32-Codes für virtuelle Tasten, benannt nach der .NET-Enumeration Keys (unten aufgeführt)jede Keyboard*-Funktion, die einen Integer key annimmt

VirtualKey-Member​

Die Oem*-Tasten sind nach dem Zeichen benannt, das sie auf einer US-Tastatur erzeugen. Die physische Taste hängt vom Tastaturlayout ab.

LButton RButton Cancel MButton XButton1 XButton2 Back Tab Clear Enter ShiftKey ControlKey Menu Pause CapsLock Escape Space PageUp PageDown End Home Left Up Right Down Select Print Execute PrintScreen Insert Delete Help D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z LWin RWin Apps Sleep NumPad0 NumPad1 NumPad2 NumPad3 NumPad4 NumPad5 NumPad6 NumPad7 NumPad8 NumPad9 Multiply Add Separator Subtract Decimal Divide F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 NumLock Scroll LShiftKey RShiftKey LControlKey RControlKey LMenu RMenu BrowserBack BrowserForward BrowserRefresh BrowserStop BrowserSearch BrowserFavorites BrowserHome VolumeMute VolumeDown VolumeUp MediaNextTrack MediaPreviousTrack MediaStop MediaPlayPause LaunchMail SelectMedia LaunchApplication1 LaunchApplication2 OemSemicolon Oemplus Oemcomma OemMinus OemPeriod OemQuestion Oemtilde OemOpenBrackets OemPipe OemCloseBrackets OemQuotes Oem8 Oem102

Text für Tastenkombinationen (KeyboardPressKeyCombo)​

KeyboardPressKeyCombo nimmt Text an, keine Konstante: beliebig viele Modifizierer-Präfixe, dann genau eine Taste. Eine Kombination pro Aufruf, ohne Wiederholungsanzahl. Nach der Taste darf nichts folgen: "^cx" oder "Control+V" ist ein Fehler, kein Druck der ersten Taste.

Präfix^+%@
ModifiziererStrgUmschaltAltWin

Die Taste ist ein einzelner Buchstabe oder eine Ziffer (Groß- oder Kleinschreibung) oder einer dieser Namen in geschweiften Klammern, in beliebiger Groß-/Kleinschreibung: {ENTER} {ESC} {TAB} {DEL} {BS} {SPACE} {HOME} {END} {PGUP} {PGDN} {LEFT} {RIGHT} {UP} {DOWN} {INSERT} {F1}…{F24} {PRTSC} {CAPSLOCK} {NUMLOCK} {SCROLLLOCK} {BREAK} {HELP} {CLEAR} {NUMPAD0}…{NUMPAD9} {MULTIPLY} {ADD} {SEPARATOR} {SUBTRACT} {DECIMAL} {DIVIDE}. {ESCAPE}, {DELETE}, {BACKSPACE}, {BKSP} und {INS} funktionieren ebenfalls.

Beispiele: "^c" Strg+C · "^+{ESC}" Strg+Umschalt+Esc · "%{F4}" Alt+F4 · "@d" Win+D · "^{HOME}" Strg+Pos1 · "{enter}" Eingabe.

Sie kennen SendKeys aus .NET? Die Präfixe und die Namen in geschweiften Klammern folgen der SendKeys-Syntax von Microsoft. Dieser Text ergänzt @ für die Windows-Taste sowie {NUMPAD0}…{NUMPAD9}, {SEPARATOR} und {DECIMAL} für die eigenen Tasten des Ziffernblocks. Für mehrere Tasten in einem Text verwenden Sie KeyboardSendKeys, unten.

Tastenfolgen (KeyboardSendKeys)​

KeyboardSendKeys nimmt eine ganze Folge im SendKeys-Format von Microsoft an, mit @ für die Windows-Taste wie oben; jede Tastenkombination ist also auch eine Folge.

SchreibenSendet
abcdie Zeichen, unverändert getippt, auf jedem Tastaturlayout
^ + % @ vor einer TasteStrg, Umschalt, Alt oder Windows, für diese Taste gehalten: "^a" ist Strg+A
~Eingabe
{TAB}, {F5}, …eine Taste über ihren Namen, die Namen oben
{LEFT 5}, {a 3}die Taste oder das Zeichen so oft, 1 bis 1000
+(abc)Umschalt, gehalten für jede Taste in den Klammern
{+} {^} {%} {~} {@} {(} {)} {{} {}}genau dieses Zeichen

Beispiele: "{TAB 3}^a" dreimal Tab, dann Strg+A · "^s{ENTER}" Strg+S, dann Eingabe · "%(fx)" Alt+F, dann Alt+X · "me{@}example.com~" die Adresse, dann Eingabe.

Der ganze Text wird geprüft, bevor eine Taste gedrückt wird. Ein Fehler an beliebiger Stelle darin, etwa ein unbekannter Name in geschweiften Klammern oder eine { ohne }, beendet die Aktion mit einem Fehler, der das Zeichen nennt, und nichts wird gesendet. Eine Folge hat höchstens 4096 Zeichen und 10.000 Tastenanschläge, Wiederholungen mitgezählt. Jeder Tastenanschlag wartet die Einstellung Tippverzögerung, wie bei KeyboardTypeText, außer dass eine wiederholte Pfeiltaste, Pos1, Ende, Bild auf oder Bild ab auf einmal gesendet wird.

Bei gehaltener Strg-, Alt-, Umschalt- oder Windows-Taste ist ein Buchstabe, eine Ziffer oder ein Leerzeichen auf jedem Tastaturlayout dieselbe Taste. Jedes andere Zeichen wird im Layout des Fensters im Vordergrund nachgeschlagen: "^;" ist auf einem deutschen Layout eine andere Taste als auf einem US-Layout, und ein Zeichen, das dieses Layout nicht mit einer Zusatztaste tippen kann, ist ein Fehler.

Ein Buchstabe nach einer Zusatztaste ist seine Taste, ob großgeschrieben oder nicht: "^A" ist Strg+A, genau wie "^a". Für Strg+Umschalt+A schreiben Sie "^+a". SendKeys von Microsoft fügt für einen Großbuchstaben Umschalt hinzu; ein Import aus StrokesPlus.net schreibt das Umschalt daher für Sie aus.

Senden Sie reinen Text mit KeyboardTypeText, nicht mit KeyboardSendKeys. Hier sind + ^ % ~ @ ( ) { } Befehle, keine Zeichen: "50% off" drückt Alt+Leertaste, und in "[email protected]" hält das @ die Windows-Taste für das e. Text, den Sie nicht selbst geschrieben haben, etwa die Zwischenablage oder eine Variable, kann jedes davon enthalten; übergeben Sie ihn daher nie an KeyboardSendKeys.