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.
| Namespace | Member = Wert | Verwendet von |
|---|---|---|
MouseButton | Left=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6 | MouseClick, 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. |
FileNotify | FileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100 | filterMask von FolderWatchCreate. Das sind Bitflags; kombinieren Sie sie daher mit |. |
AudioEndpoint | Playback=0 Capture=1 Communications=2 | die Multimedia*-Funktionen für Lautstärke und Stummschaltung |
WindowStyle | Normal=0 Minimized=1 Maximized=2 Hidden=3 | ShellRunProgram |
ShellVerb | Open=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6 | verb von ShellRunProgram, das auch jedes andere Verb als Text akzeptiert |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | location von UIShowDisplayMessage, das auch einen Bildschirmpunkt als Text "x,y" akzeptiert |
TextAlign | Left=0 Center=1 Right=2 | UIShowDisplayMessage/UIUpdateDisplayMessage |
LockResult | Acquired=0 TimedOut=1 Pinned=2 | zurückgegeben von UtilityLockAcquire/UtilityLockAcquirePinned |
LockState | Free=0 HeldByMe=1 HeldByOther=2 Pinned=3 | zurückgegeben von UtilityLockGetState |
SerialParity | None=0 Odd=1 Even=2 Mark=3 Space=4 | SerialOpenPort, SerialMonitorCreate |
SerialStopBits | One=0 OnePointFive=1 Two=2 | SerialOpenPort, SerialMonitorCreate |
DateTimeStyle | ShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6 | DateTimeFormat. 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. |
DateTimePart | Year=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6 | DateTimeGetPart. Gregorianisch, Ortszeit. Weekday folgt ISO: 1 ist Montag, 7 ist Sonntag. |
VirtualKey | die 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 | ^ | + | % | @ |
|---|---|---|---|---|
| Modifizierer | Strg | Umschalt | Alt | Win |
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.
| Schreiben | Sendet |
|---|---|
abc | die Zeichen, unverändert getippt, auf jedem Tastaturlayout |
^ + % @ vor einer Taste | Strg, 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.