Schrittparameter
Wenn Sie einen Schritt auswählen, öffnen sich darunter seine Felder, eines pro Angabe, die der Schritt braucht. Jedes Feld ist in verständlichen Worten beschriftet. Zeigen Sie mit der Maus auf ein Feld, um eine QuickInfo zu sehen, wofür es da ist.
Arten von Feldern
| Feld | Sieht aus wie | Nimmt an |
|---|---|---|
| Text | ein Textfeld | beliebigen Text |
| Ganze Zahl | ein Textfeld | eine ganze Zahl, etwa 250 oder -3, eine hexadezimale Zahl mit 0x am Anfang, etwa 0xB3, oder eine benannte Konstante, etwa VirtualKey.MediaPlayPause |
| Zahl | ein Textfeld | eine Zahl mit einem Punkt als Dezimaltrennzeichen, etwa 0.5, unabhängig von Ihrem Regionalformat |
| Wahr oder falsch | ein Schalter | ein (true) oder aus (false) |
| Eine Auswahl benannter Werte | eine Dropdownliste ② | einen der aufgeführten Namen, etwa MouseButton.Primary; Sie können auch hineintippen |
| Fenster | ein Textfeld | ein Fenster aus dem Wertemenü oder aus einer Variablen, normalerweise Zielfenster |
| Tasten (Tasten senden) | ein Feld zum Erfassen von Tasten | die Tastenkombination, die Sie drücken |
In jeder Art von Feld können Sie auch $ und den Namen einer Variablen tippen, um einen Wert zu
verwenden, den ein früherer Schritt gespeichert hat (Variablen).
Eine Zahl im Feld eines Schritts verwendet immer einen Punkt als Dezimaltrennzeichen und keine Tausendertrennzeichen, unabhängig von Ihrem Regionalformat.
Benannte Konstanten
Ein Feld für eine ganze Zahl oder eine Zahl nimmt auch eine benannte Konstante an: einen Namensraum,
einen Punkt und einen Namen, etwa VirtualKey.MediaPlayPause oder AudioEndpoint.Playback, dieselben
Namen, die ein Skript verwendet (Benannte Konstanten). Tippen Sie sie genau
so, mit denselben Großbuchstaben und ohne Leerzeichen. Der Schritt speichert den Namen, und die Aktion
verwendet bei der Ausführung seine Zahl. Ein Textfeld behält einen solchen Namen als den eingegebenen
Text.
Das Feld „Tasten“
Tasten senden hat statt eines Textfelds ein Erfassungsfeld. Klicken Sie darauf (Klicken, um ein
Tastenkürzel festzulegen), und drücken Sie dann die Kombination. Nur die Kombination wird aufgezeichnet;
beim Festlegen wird nichts gesendet. Tasten, die eine Tastenkombination nicht benennen kann, etwa
Medientasten, werden mit einer Meldung abgelehnt. Um diese zu drücken, verwenden Sie den Schritt Taste
drücken und loslassen (KeyboardPressKey) mit dem Namen der Taste, etwa VirtualKey.MediaPlayPause
(Ausgearbeitete Rezepte).
Neue Schritte sind vorausgefüllt
Die Felder Fenster eines neuen Schritts beginnen mit Zielfenster: dem Fenster, über dem die Geste gezeichnet wurde, oder bei einem Hotkey oder getipptem Text dem Fenster mit dem Fokus. Seine Schalter beginnen ausgeschaltet. Jedes andere Feld beginnt leer, damit Sie es ausfüllen.
Einen Wert aus dem Menü wählen
Jedes Feld außer Tasten und den Schaltern hat an seinem Ende einen kleinen Pfeil (Wert auswählen). Er öffnet ein Menü mit Werten, die zum Feld passen ①. Neben den eigenen Feldern eines Schritts gibt es das Menü bei den Feldern Wert und Verglichen mit einer Bedingung und ihrem einzelnen Wert (Bedingungen), bei der Anzahl einer Wiederholung (Schritte wiederholen) und beim Wert eines Schritts Variable setzen (Variablen).
| Abschnitt | Werte |
|---|---|
| Vom Auslöser der Aktion | Zielfenster, Ziel-Steuerelement, Name der Geste, Name der Aktion, Name der App-Gruppe, Gestentaste sowie Linker Rand der Geste, Oberer Rand der Geste, Breite der Geste und Höhe der Geste |
| Beim Ausführen des Schritts gelesen | Aktives Fenster, X-Position der Maus, Y-Position der Maus, Text in der Zwischenablage, Aktuelles Datum und Uhrzeit |
| Von früheren Schritten gespeichert | die Variablen, die Schritte oberhalb dieses Schritts speichern |
Das Menü listet nur Werte der Art des Felds auf: Ein Feld für eine Zahl nimmt auch ganze Zahlen an, und ein Feld, das alles annimmt, nimmt alle an. Anzahl bietet nur ganze Zahlen an; die Felder einer Bedingung und der Wert von Variable setzen bieten jeden Messwert an. Passt nichts, sagt das Menü Für dieses Feld gibt es keine Auswahl.
Ein gewählter Wert erscheint als Chip mit seinem Namen anstelle des Textfelds. Zeigen Sie mit der Maus auf den Chip, um zu sehen, was er ist und wie ein Skript ihn schreibt. Seine Schaltfläche Leeren leert das Feld, damit Sie wieder tippen können.
Die Werte unter Vom Auslöser der Aktion lesen den Auslöser: Bei einer Aktion, die durch einen Hotkey oder getippten Text gestartet wurde, sind die Gestenwerte leer oder 0. Jeder Wert wird überall angeboten, wo Schritte laufen, weil ein Snippet von überall aufgerufen werden kann.
Bei einem Schalter erscheint eine zuvor eingegebene Variable als Chip; das Leeren des Chips schaltet den Schalter aus.
Prüfungen beim Tippen
Jedes Feld wird beim Tippen geprüft. Ein Problem erscheint rot unter dem Feld, und der Rahmen des Felds wird rot:
| Meldung | Bedeutung |
|---|---|
| Dieser Wert ist erforderlich. | Der Variablenname eines Schritts Variable setzen ist leer. |
| Geben Sie eine ganze Zahl (dezimal oder hexadezimal mit 0x), eine benannte Konstante oder eine $Variable ein. | Ein Feld für eine ganze Zahl enthält etwas anderes. |
| Es gibt keine benannte Konstante mit diesem Namen. Prüfen Sie Schreibweise sowie Groß- und Kleinschreibung, wie in VirtualKey.MediaPlayPause. | Ein Feld für eine ganze Zahl oder eine Zahl enthält einen Namensraum, einen Punkt und einen Namen, der keine benannte Konstante ist. |
| Geben Sie eine Zahl oder eine $Variable ein. | Ein Feld für eine Zahl enthält etwas anderes. |
| Geben Sie true oder false oder eine $Variable ein. | Ein als Text getipptes Feld für Wahr oder falsch enthält etwas anderes. |
| Ein Schritt kann keine integrierte Funktion innerhalb eines Arguments ausführen. Verschieben Sie sie zuerst in eine Variable. | Das Feld enthält einen Funktionsaufruf mit etwas in den Klammern (siehe unten). |
Solange ein Feld getippten Text enthält, der seine Prüfung nicht besteht, etwa Buchstaben in einem Feld
für eine ganze Zahl oder eine Zahl, einen Namen, der keine benannte Konstante ist, oder etwas anderes als
true oder false in einem Feld für Wahr oder falsch, werden die Schritte nicht gespeichert: Die Aktion
behält ihre zuletzt gespeicherten Schritte, und Schritte nicht gespeichert: Schritt N hat ein
ungültiges Feld erscheint unter der Liste, bis Sie das Feld korrigieren
(Gemeldete Probleme).
Ein leeres Feld zeigt keine Meldung und verhindert nie das Speichern; die Schritte werden mit dem leeren Feld gespeichert. Wenn die Aktion läuft, stoppt ein Schritt mit einem leeren Feld für eine Zahl, Wahr oder falsch oder ein Fenster die Aktion an dieser Stelle, und die Ausgabe System der Konsole meldet, dass dieses Argument den falschen Typ hat. Ein leeres Textfeld läuft als leerer Text, was bei manchen integrierten Funktionen (ein Dateiname, ein zu suchender Fenstertitel) bedeutet, dass der Schritt nichts tut.
In eine Variable verschieben
Ein Feld enthält einen Wert, eine Variable oder einen der Messwerte aus dem Wertemenü, nie einen Aufruf
einer integrierten Funktion mit Argumenten. Tippen Sie einen ein, etwa WindowGetTitle($w), bietet das
Feld In eine Variable verschieben an. Das fügt direkt über diesem einen Schritt hinzu, der den Aufruf
ausführt und das Ergebnis unter einem aus dem Feld abgeleiteten Namen speichert (etwa window, dann
window2), und setzt diese Variable in das Feld.
Ein Aufruf ohne etwas in den Klammern, etwa ClipboardGetText(), ist in Ordnung: Er entspricht der Wahl
dieses Messwerts im Wertemenü. Das gilt in jedem Feld mit dem Wertemenü, einschließlich der Felder einer
Bedingung, Anzahl und dem Wert von Variable setzen.
Das Ergebnis eines Schritts behalten
Die meisten integrierten Funktionen liefern ein Ergebnis: den gelesenen Text, das gefundene Fenster oder
ob sie funktioniert haben. Ergebnis speichern als ③ behält es unter einem Namen, sodass spätere
Schritte es als $name verwenden können. Lassen Sie es leer, um das Ergebnis zu ignorieren.
Ein Schritt, der sein Ergebnis behält, zeigt am Ende seiner Zusammenfassung „→ $name“. Namen folgen den Regeln unter Variablen.
Falsche Arten zur Laufzeit
Der Editor prüft die Form Ihrer Eingabe, nicht jede Regel der integrierten Funktion. Wenn die Aktion läuft, stoppt ein Wert der falschen Art (zum Beispiel eine Variable mit Text, wo eine Funktion eine ganze Zahl braucht) oder ein Wert, den die Funktion ablehnt, die Aktion mit einem Fehler in der Diagnosekonsole. Siehe Fehler.