Snippets
Ein Snippet ist ein benanntes Stück aus Schritten oder Skript, das an keinen Auslöser gebunden ist. Aktionen, Vorher- und Nachher-Skripte, globale Ereignisse und andere Snippets führen es über seinen Namen aus. Schreiben Sie etwas einmal als Snippet, und jede Aktion, die es aufruft, verwendet dieselbe Kopie: Ändern Sie das Snippet, ändern sich alle.
Die Snippet-Liste
Die Liste zeigt jedes Snippet der Bibliothek unter einer Überschrift pro Kategorie: Kategorien von A bis Z, dann Ohne Kategorie, und innerhalb jeder Kategorie nach Namen von A bis Z. Ein Snippet, das von etwas aufgerufen wird, zeigt Verwendet von und die Anzahl der Aufrufer.
- + Neu fügt in der Kategorie des ausgewählten Snippets ein Snippet namens Neues Snippet hinzu, geschrieben als Schritte.
- Die Duplizieren-Schaltfläche neben + Neu kopiert das ausgewählte Snippet unter einem neuen, eindeutigen Namen.
- Die Löschschaltfläche einer Zeile löscht ein Snippet (Ein Snippet löschen).
Name und Kategorie
- Über den Name ① finden Aufrufer das Snippet. Er muss in der ganzen Bibliothek eindeutig sein, unabhängig von der Kategorie, und zwei Namen, die sich nur in Groß- und Kleinschreibung unterscheiden, gelten als gleich. Er darf kein doppeltes Anführungszeichen, keinen umgekehrten Schrägstrich und kein Steuerzeichen enthalten. Ein Name, der gegen eine Regel verstößt, wird rot mit dem Grund angezeigt und springt beim Verlassen des Felds auf den alten Namen zurück.
- Umbenennen eines Snippets schreibt jeden Aufruf, der es in Anführungszeichen nennt, überall in Ihrer Konfiguration um (Wer ein Snippet aufruft).
- Kategorie ② gruppiert nur die Liste. Sie ändert nicht, wie das Snippet ausgeführt wird.
Was das Snippet tut
Geschrieben als wählt Schritte oder Skript, wie bei einer Aktion (Schritte, Skript und AutoHotkey). Ein Wechsel von Schritten zu Skript bietet an, die Schritte zu übersetzen, wie auf der Seite „Aktionen“.
- Bei „Schritte“ ist der Editor derselbe wie bei einer Aktion (Der Schritte-Editor).
- Bei „Skript“ prüft Syntax prüfen das Skript mit dem eigenen Compiler der Engine. Es meldet Syntax OK mit der Zeilenzahl oder den ersten Fehler und unterstreicht das Problem im Editor.
- AutoHotkey wird nur für ein Snippet angeboten, das bereits als AutoHotkey ausgeführt wird.
- Hier gibt es keine Schaltfläche, um ein Snippet auszuführen. Um Schritte gefahrlos auszuprobieren, verwenden Sie die Sandbox.
Modus „Erweitert“. Über dem Editor wird der Aufruf, der dieses Snippet ausführt ③, in Skriptform angezeigt, mit einer Schaltfläche, die ihn kopiert.
Ein Snippet aufrufen
Ein Snippet wird ausgeführt, wenn ein Schritt oder ein Skript die integrierte Funktion
SnippetExecuteScript mit seinem Namen aufruft:
- Fügen Sie bei „Schritte“ einen Schritt Snippet ausführen (
SnippetExecuteScript) aus der Liste aller integrierten Funktionen hinzu (Schritte hinzufügen), und tippen Sie den Namen des Snippets als seinen Name ein. - Schreiben Sie bei „Skript“ den Aufruf:
SnippetExecuteScript("Center window");
Wie es ausgeführt wird:
- Der Aufrufer wartet, bis das Snippet fertig ist, und macht dann weiter.
- Das Snippet sieht, was den Aufrufer gestartet hat (sein Zielfenster, seine Geste und so weiter); Zielfenster in einem Snippet ist also das Zielfenster des Aufrufers.
- Das Snippet hat eigene Variablen. Es kann die des Aufrufers nicht lesen, und der Aufrufer nicht seine.
- Der Name muss genau passen, einschließlich Groß- und Kleinschreibung. Hat kein Snippet diesen Namen,
wird nichts ausgeführt, und der Aufruf ergibt
false. - Der Aufruf ergibt nur
true, wenn das Snippet bis zum Ende gelaufen ist. Er ergibt auchfalse, wenn das Snippet leer ist, einen Fehler hat oder gestoppt wird. - Ein Snippet kann andere Snippets aufrufen. Nichts hindert ein Snippet daran, sich selbst aufzurufen; stellen Sie also sicher, dass eine solche Kette endet.
Wer ein Snippet aufruft
Die Karte Aufgerufen von ④ listet jede Aktion, jedes Vorher- oder Nachher-Skript, jedes globale Ereignis (auch ein ausgeschaltetes) und jedes Snippet auf, das dieses Snippet aufruft. Ein globales Ereignis ist mit Globales Ereignis markiert, ein Snippet mit Snippet.
Gefunden werden nur Aufrufe, die den Namen des Snippets ausgeschrieben in Anführungszeichen enthalten. Ein Aufruf, der den Namen zur Laufzeit zusammensetzt, wird nicht aufgeführt, ein Aufruf in einem Kommentar dagegen schon. AutoHotkey-Inhalte werden nicht durchsucht.
Ein Snippet löschen
Sie können ein Snippet nicht löschen, solange etwas unter Aufgerufen von es noch aufruft. Die Löschschaltfläche zeigt dann … kann nicht gelöscht werden mit der Liste der Aufrufer; ändern oder entfernen Sie diese Aufrufe zuerst. Ein Snippet, das nichts aufruft, wird nach einer Rückfrage gelöscht.
Ein Aufruf, den die Liste nicht sehen kann (ein zur Laufzeit gebildeter Name), ist nicht geschützt:
Löschen Sie dieses Snippet, findet der Aufruf nichts und ergibt false.
Snippets von anderswo
- Snippet erstellen auf der Seite Rekorder macht aus einer Aufzeichnung ein Snippet.
- Als Snippet speichern auf der Seite Sandbox speichert die Schritte oder das Skript, die Sie dort ausprobiert haben.
Beide öffnen das neue Snippet auf dieser Seite mit dem Cursor in seinem Name, bereit zum
Umbenennen. An einen bereits vergebenen Namen wird -1, -2 und so weiter angehängt.