StructorizerHandbuch DE

Content Assist (Eingabevervollständigung)

Version 3.32-11 brachte eine lang vermisste Neuerung: einen Content Assist für den Texteingabebereich des Element-Editors. Er bietet Autovervollständigungsfunktionalität.

Wenn Sie Elementtext eingeben (wie auf den Elements-Seiten beschrieben), schlägt der Content Assist Ihnen Befehlsschlüsselwörter, Namen deklarierter Variablen und Konstanten sowie andere sinnvolle Wortvorschläge vor, die mit den eingegebenen Zeichen als Präfix übereinstimmen. Die Vorschläge können vom Elementtyp und der Cursorposition abhängen. Wenn Sie z. B. einen Instruction-Text bearbeiten und der Cursor am Anfang einer Zeile steht, gehören die in den Parser Preferences konfigurierten Schlüsselwörter für input- und output-Anweisungen zu den angebotenen Auswahlmöglichkeiten:

Content Assist für ein Instruction-Element
Content Assist für ein Instruction-Element

Der Screenshot zeigt, dass die Übereinstimmung ohne Rücksicht auf die Groß-/Kleinschreibung erfolgt.

Über den Spinner „Suggestion threshold" (Vorschlagsschwelle) rechts oberhalb des Textbereichs der meisten Editoren können Sie die Mindestlänge des Präfixes angeben, das Vorschläge in einer Aufklappliste auslöst. Der Wert kann im Bereich von 1 bis 5 liegen. Durch Wahl von 0 können Sie den Content Assist deaktivieren. Bei Wahl von z. B. 2 (Standard) löst das zweite eingetippte Zeichen (das als Teil eines Bezeichners erlaubt ist) den Content Assist aus, um eine Aufklappliste passender relevanter Wörter anzuzeigen (sofern vorhanden). Im folgenden Screenshot werden die Variablennamen dargestellt, die mit dem eingegebenen Präfix „da" beginnen:

Content Assist schlägt Variablennamen vor
Content Assist schlägt Variablennamen vor

Um einen der Vorschläge anzunehmen, wählen Sie ihn (mit den Tasten /) aus und drücken Sie Enter. Dadurch wird das gewählte Wort an der aktuellen Cursorposition eingefügt (das übereinstimmende Präfix wird ersetzt, wenn sich die Groß-/Kleinschreibung unterscheidet). Wenn Sie die Auswahl bereuen, können Sie sie einfach rückgängig machen (StrgZ) oder so viele der eingefügten Zeichen löschen, bis der Content Assist wieder mehr Vorschläge anbietet. Wenn Sie keinen Vorschlag übernehmen möchten, tippen Sie einfach weiter und ignorieren Sie die Aufklappliste. Die Aufklappliste verschwindet, sobald keine übereinstimmenden Wörter mehr verfügbar sind.

Am Anfang von EXIT-Zeilen (Sprung-Elemente) werden die drei konfigurierten Befehlsschlüsselwörter zum Verlassen einer Schleife, einer Routine oder des Programms sowie das Schlüsselwort zum Auslösen einer Ausnahme angeboten. Eines davon muss am Anfang des Textes stehen, bevor Variablennamen oder andere relevante Inhalte vorgeschlagen werden.

In einem CALL-Element gehören die Signaturen der aktuell verfügbaren Unterroutinen-Diagramme zu den Auswahlmöglichkeiten:

Content Assist bietet Routinen-Signaturen an
Content Assist bietet Routinen-Signaturen an

Wenn Sie eine der angebotenen Unterroutinen-Signaturen einfügen, ändert sich deren Darstellung geringfügig: Anstelle der Argumentanzahl (oder des Argumentanzahlbereichs) wird eine formale Argumentliste mit einem Fragezeichen an jeder obligatorischen Argumentposition und lediglich einer Auslassung für alle optionalen Argumente zusammen dargestellt:

Content Assist mit eingefügter Unterroutinen-Signatur
Content Assist mit eingefügter Unterroutinen-Signatur

Der Content Assist ist natürlich auch beim Bearbeiten vorhandener Elemente aktiv. (Möglicherweise müssen Sie nur ein Wort ändern, um Inhaltsvorschläge zu erhalten.)

Wenn Sie nach einem Variablenkonstrukt einen Punkt setzen und der Content Assist den Datentyp des vorangegangenen syntaktischen Konstrukts ableiten kann und es sich dabei um eine Record-Variable handelt, bietet der Content Assist alle Komponentennamen des spezifischen Record-Typs an (Sie können die Auswahl durch weitere Eingaben einschränken):

Content Assist mit Komponentennamen-Vorschlägen
Content Assist mit Komponentennamen-Vorschlägen

Der Content Assist versucht auch, bei Typdefinitionen und Variablendeklarationen zu helfen:

Content Assist in einer Typdefinition
Content Assist in einer Typdefinition
Content Assist in einer Record-Definition
Content Assist in einer Record-Definition

Die Tiefe der syntaktischen Analyse ist begrenzt, sodass bei komplizierten Strukturen die Autovervollständigungsvorschläge möglicherweise weniger nützlich sind. In den meisten Standardsituationen sollte sie jedoch die Eingabe des Elementtexts erheblich beschleunigen und zur Verwendung längerer und ausdrucksstärkerer Variablennamen ermutigen.

Hinweis: Der Content Assist ist auch an bestimmte Formularfelder in spezialisierten Element-Editor-Varianten angehängt, wie z. B. dem FOR-Schleifen-Editor:

Content Assist in FOR-Editor-Formularfeldern
Content Assist in FOR-Editor-Formularfeldern