Code-Bibliothek

Aufruf über Menü: Fenster - Codebibliothek

Dieser Dialog ermöglicht das Verwalten von Skriptabschnitten ("Codeschnipsel") für das Wiederverwenden von Code.

Um einmal erstellte Skriptteile ("Codeschnipsel"), in denen beispielsweise spezielle Berechnungsalgorithmen, Funktionen oder die Definition bestimmter Dialoge enthalten sind, ablegen und jederzeit wiederverwenden zu können, ist die Code-Bibliothek ein ideales Werkzeug. Durch die Einteilung der Schnipsel in Typen ist eine Kategorisierung möglich, etwa für Dialoge, Algorithmen oder spezielle Tricks.

Die Baumansicht links stellt die unterschiedlichen Quellen der Schnipsel sowie die darin enthaltenen Kategorien dar. Durch Anklicken eines Zweigs wird die Liste entsprechend eingeschränkt, während über den obersten Eintrag Code-Bibliothek die komplette Liste dargestellt wird.

Sie können jederzeit in der Liste einen Eintrag anwählen und den Namen bzw. die Beschreibung ändern.

Um einen Codeabschnitt in das aktuelle Skript zu übernehmen, wählen Sie den Eintrag an und klicken die Schaltfläche In Skript einsetzen an (oder drücken im Normalzustand einfach die Enter-Taste). Der Code wird dann an der aktuelle Position im Skript eingefügt.

Optional können Sie den Code auch über das Clip-Symbol in die Zwischenablage kopieren lassen, aus der Sie ihn dann an einer beliebigen Stelle im Skript einfügen können.

Ist der Schalter Regionsangaben mit kopieren aktiviert, werden die Schnipsel einschließlich der Regionsinformationen in das Skript eingesetzt.

Aktuell: Hier werden die aktuellen Codebereiche angezeigt.
Um einen Skriptabschnitt aus dem aktuellen Skript in die Bibliothek zu übernehmen, markieren Sie ihn und rufen den Code-Bibliothek-Dialog auf.
Am Anfang der Liste steht dann _NEU mit der Beschreibung ** aktuell markierter Code aus "X"** (wobei n für die Anzahl der markierten Zeilen und X für den aktuellen Skripttitel steht), was den im Skript markierten Bereich repräsentiert. Sie können nun unter der Liste einen Titel sowie eine Beschreibung für das Schnipsel eingeben und über die Schaltfläche Übernehmen in die Liste aufnehmen.
Sollte in der Zwischenablage ein kopierter Skriptabschnitt bzw. ein cX2Web-Code enthalten sein, wird dieser ebenfalls hier angezeigt.

Bibliothek: Die in diesem Bereich angezeigte grundlegende Codebibliothek wird in einem Skript namens CodeLib.CX4 im click.EXE-Verzeichnis abgelegt. In diesem Skript sind alle Schnipsel als Regionen markiert, was automatisch erstellt und verwaltet wird - direkte Änderungen in diesem Skript sind nicht empfehlenswert.

Dateien: Ist im \Skripte-Verzeichnis ein Ordner namens \CodeBibliothek enthalten, werden die hier enthaltenen Skripte in diesem Zweig aufgeführt. Sind weitere Unterverzeichnisse in dem Ordner enthalten, werden die dort liegenden Skripte ebenfalls angezeigt, wobei die Ordnernamen als Typ in der Liste angezeigt werden. Das Ändern der Eigenschaften ist für diese Schnipsel nicht möglich (nur Löschen).

Server: Dieser Zweig zeigt die auf dem click.EXE-Server hinterlegten Schnipsel an. Beim Aufklappen werden die Daten der Schnipsel heruntergeladen und in den Zweig eingefügt.

Spezielle Abfrage-Platzhalter:

In den Schnipseln können auch spezielle Abfrage-Platzhalter eingebaut werden, die dann beim Einfügen in das Skript abgefragt und ersetzt werden. Auf diese Weise können hier spezielle Bezeichnungen oder Variablen beim Einsetzen angepasst werden, um verschiedene Versionen des Codeschnipsels in das Skript einsetzen zu können.

Solche Platzhalter haben den Aufbau

[>>Abfragetext:Vorgabe<<]

Der Abfragetext erscheint in der Abfrage, wenn das Schnipsel eingesetzt werden soll, während die (optionale) Vorgabe in die Abfrage eingetragen ist. Wird die Abfrage mit Abbrechen quittiert, wird das Schnipsel nicht eingesetzt, ebenso wenn die Abfrage mit einem leeren Inhalt bestätigt wird.

Taucht ein solcher Platzhalter mit dem selben Abfragetext noch einmal im Schnipsel auf, wird nicht noch einmal gefragt, sondern der beim ersten Mal eingegebene Text eingefügt.

Ist in einem Abfrage-Platzhalter lediglich ein Platzhalter selbst enthalten, wird dieser direkt ersetzt (z.B. [>>[cX.Datum]<<] für das Einsetzen des aktuellen Datums). Ebenso werden Platzhalter innerhalb der Vorgabe ersetzt (z.B. [>>Autor:[System.BenutzerName]<<]).

Das Übernehmen eines Schnipsels mit gedrückter Umschalt-Taste übergeht diese Abfragen.

Hier ein Beispiel für die Anwendung solcher Abfragen:

***  Dies ist ein Kommentar zum Thema "[>>Codeschnipsel-Thema?:Beispielthema<<]"!
     Meldung  "[>>Codeschnipsel-Thema?<<]" (Titel: 'Info', 'OK, Abbrechen')
***  Auch dieser Kommentar gehört zum Thema "[>>Codeschnipsel-Thema?<<]"...

Wird hier beim Einfügen bei der Abfrage "Codeschnipsel-Thema?" beispielsweise "Test" eingegeben, wird folgender Code in das Skript eingefügt:

***  Dies ist ein Kommentar zum Thema "Test"!
     Meldung  "Test" (Titel: 'Info', 'OK, Abbrechen')
***  Auch dieser Kommentar gehört zum Thema "Test"...

cX-Webseite: http://www.clickexe.de