Konsole
Die Konsole ist das eigene Fenster der Engine zum Diagnostizieren und Ausprobieren. Sie zeigt, was die Engine meldet (Probleme in Ihrer Konfiguration, fehlgeschlagene Skripte, Plug-ins, auf deren Zeichnen verzichtet wurde), zeigt, was Ihre Skripte ausgeben, und hat einen Editor, in dem Sie ein Skript direkt schreiben und ausführen können.
Die Konsole öffnen
Wählen Sie im Menü des Infobereichssymbols Konsole anzeigen (Das Symbol im Infobereich),
oder führen Sie die integrierte Funktion UIShowConsole aus einer Aktion aus – binden Sie sie zum
Beispiel an einen Hotkey. Nichts öffnet die Konsole automatisch, außer Sie verlangen es mit Bei
Meldung (siehe unten).
Ist Ihre Konfiguration kennwortgeschützt, fragt die Konsole beim Öffnen nach dem Kennwort, außer es ist
noch gespeichert (Sicherheit). Solange die Konsole geöffnet ist, läuft das
gespeicherte Kennwort nicht ab. UIShowConsole wartet, bis die Konsole geöffnet ist, auch während der
Kennwortabfrage, und ergibt false, wenn sie sich nicht geöffnet hat, zum Beispiel weil die
Kennwortabfrage abgebrochen wurde.
Die Konsole wird mit ihrer Schließen-Schaltfläche geschlossen. Das Schließen gibt den von ihr belegten Speicher frei.
Die drei Bereiche
Die Schaltflächen oben ① wechseln zwischen drei Bereichen, jeder mit eigener Symbolleiste.
| Bereich | Was er zeigt | Symbolleiste |
|---|---|---|
| System | Was die Engine meldet: Hinweise zu Ihrer Konfiguration vom letzten Laden, fehlgeschlagene Aktionen und Skripte samt Grund, ein Plug-in, das nicht zeichnen konnte, sodass das integrierte Zeichnen übernommen hat, und Ähnliches. | Kopieren, Leeren, Bei Meldung |
| Benutzer | Alles, was Ihre Skripte mit UtilityPrint ausgeben, aus jeder Aktion. | Kopieren, Leeren, Bei Meldung |
| Skript | Einen Skripteditor über einem Ausgabebereich. | Ausführen, Alle beenden, Konsole ausblenden, Skripthilfe, Kopieren, Einfügen, Leeren |
Kopieren kopiert den markierten Text oder, wenn nichts markiert ist, den ganzen Bereich. Leeren leert den Bereich.
Solange der Bereich Skript angezeigt wird, erscheinen neue Zeilen aus System und Benutzer auch in seinem Ausgabebereich, sodass Sie ein laufendes Skript beobachten können, ohne den Bereich zu wechseln.
Solange die Konsole geschlossen ist
Zeilen, die eintreffen, während die Konsole geschlossen ist, gehen nicht verloren: Sie werden in temporären Dateien aufbewahrt und beim nächsten Öffnen der Konsole angezeigt. Beim Beenden von Input.Observer werden sie gelöscht, außer dem, was das Ereignis Engine wird beendet ausgibt; das zeigt die Konsole der nächsten Sitzung.
Bei Meldung ① in den Symbolleisten System und Benutzer wählt, was eine neue Zeile bewirkt, solange die Konsole geschlossen ist:
| Auswahl | Was geschieht |
|---|---|
| Nichts tun | Die Zeile wartet, bis Sie die Konsole öffnen. Standard. |
| UIShowMessageBox anzeigen | Die Zeile erscheint zusätzlich in einem Meldungsfeld. |
| Konsole öffnen | Die Konsole öffnet sich auf diesem Bereich. |
Bei geöffneter Konsole wird eine neue Zeile einfach hinzugefügt; sie öffnet nie ein Meldungsfeld und wechselt nie den Bereich. Dieselben Auswahlen stehen auf der Seite Konsole als Neue Systemmeldungen und Neue Benutzermeldungen.
Ein Skript ausführen
- Öffnen Sie den Bereich Skript der Konsole.
- Tippen oder fügen Sie ein Skript in den Editor ein. Es verwendet die Skriptsprache von Input.Observer (Referenz der Skriptsprache).
- Wählen Sie Ausführen ②, oder drücken Sie F5. Ist Text markiert, wird nur die Markierung ausgeführt, sonst der ganze Editorinhalt.
- Die Ausgabe und eventuelle Fehler erscheinen im Ausgabebereich unter dem Editor. Konsole ausblenden blendet diesen Bereich aus oder ein.
- Ein hier ausgeführtes Skript funktioniert wie eine Aktion: Jede integrierte Funktion ist verfügbar, und es läuft, bis es fertig ist oder gestoppt wird. Alle beenden stoppt jedes laufende Skript und jede laufende Aktion, nicht nur dieses.
- Dies ist der einzige Ort, an dem im abgesicherten Modus Skripte laufen, sodass Sie untersuchen und reparieren können, während sonst nichts läuft (Problembehandlung).
- Der Editor vervollständigt Namen integrierter Funktionen beim Tippen; Strg+Leertaste listet alles auf, und das Tippen eines Bereichsnamens mit einem Punkt listet die Funktionen dieses Bereichs auf. Nach der Auswahl einer Funktion zeigt ein Tipp ihre Parameter, den aktuellen hervorgehoben. Das Kontextmenü hat Auskommentieren und Kommentierung aufheben für die markierten Zeilen.
- Der Text des Editors wird zwischen Sitzungen in
console.tomlaufbewahrt.
Skripthilfe ③ öffnet die Referenz der Skriptsprache im Hilfefenster (Das Hilfefenster), in der Sprache, die Input.Observer verwendet (oder auf Englisch, wenn es in dieser Sprache keine Hilfe gibt).
Die Seite „Konsole“
Modus „Erweitert“. Die Seite Konsole ist im Modus „Einfach“ ausgeblendet. Ihre Einstellungen bleiben wirksam.
Die Seite Konsole im Konfigurationsfenster enthält die Einstellungen der Konsole. Sie wirken, wenn Sie Anwenden oder Speichern und schließen wählen.
| Einstellung | Was sie tut | Standard | Bereich |
|---|---|---|---|
| Zeilenlimit der Konsole | Enthält ein Bereich so viele Zeilen, werden beim Eintreffen neuer die ältesten verworfen. 0 behält alles. Wirkt mit der nächsten Zeile. | 5.000 Zeilen | 0–1.000.000 |
| Speicher beim Schließen der Konsole freigeben | Gibt den Speicher der Konsole sofort nach dem Schließen an Windows zurück. Das nächste Maus- oder Tastaturereignis danach kann minimal langsamer sein. | Ein | Ein oder aus |
| Neue Systemmeldungen | Was eine neue Zeile in System bewirkt, solange die Konsole geschlossen ist: Nichts, Meldungsfeld oder Konsole öffnen (wie Bei Meldung oben) | Nichts | — |
| Neue Benutzermeldungen | Dasselbe für Zeilen in Benutzer | Nichts | — |
| Schriftart der Engine-Fenster | Schriftart und Größe für Beschriftungen und Schaltflächen der Konsole und für die Dialogfelder der Engine (Kennwort, Lizenz) | Segoe UI, 12 pt | 6–72 pt |
| Schriftart des Engine-Editors | Schriftart und Größe für die Bereiche der Konsole und ihren Skripteditor | Consolas, 13 pt | 6–72 pt |
Eine geöffnete Konsole behält ihre Schriftarten, bis Sie sie schließen und wieder öffnen.