Visualisierungselement: Texteditor

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Schriftname

Nicht proportionale Schriftart, mit der die Visualisierung den Dateiinhalt anzeigt

Beispiel: Courier New

Größe

Schriftgrad

Beispiel: 12

Datei

Variable

Variable (STRING) für den Dateinamen und optional den Speicherort der Datei

Sie liegt auf dem Dateisystem der Steuerung.

Beispiel: PLC_PRG.strFile: STRING := '/Documentation/Info.txt';

Öffnen

VariablBOOL) für das Öffnen der in Eigenschaft Variable bestimmten Datei

Beispiel: bOpen: BOOL;

TRUE: Die Datei wird geöffnet.

Falls eine andere Datei noch geöffnet ist, wird diese durch Setzen (TRUE) der Schließen-Variable geschlossen. Dabei wird automatisch aufgeräumt. Nicht gespeicherte Änderungen gehen jedoch verloren.

In einem Zyklus wird zuerst der Öffnen-Aufruf und dann der Schließen-Aufruf abgearbeitet. Wenn die auslösenden Steuervariablen gleichzeitig gesetzt werden, wird die Datei zuerst geöffnet und dann sofort wieder geschlossen.

Sobald das Öffnen- oder Neu-Flag gesetzt ist, wird beim nächsten Visualisierungszyklus diese Aktion ausgeführt und der vorhandene Dateiname ausgewertet. Beide Flags werden im gleichen Zyklus ausgewertet und können daher gleichzeitig gesetzt werden.

Schließen

Variable (BOOL) für das Schließen der in Eigenschaft Variable bestimmten Datei

Beispiel: bClose: BOOL;

TRUE: Die Datei wird geschlossen.

Hinweis: In einem Zyklus wird zuerst der Öffnen-Aufruf und dann der Schließen-Aufruf abgearbeitet. Wenn die auslösenden Steuervariablen gleichzeitig gesetzt werden, wird die Datei zuerst geöffnet und dann sofort wieder geschlossen.

Speichern

Variable BOOL) für das Speichern der in Eigenschaft Variable bestimmten Datei

Beispiel: bStore: BOOL;

TRUE: Die Datei wird gespeichert.

Neu

Variable (BOOL) für das Erzeugen einer neuen Datei mt dem in Eigenschaft Variable bestimmten Namen

Beispiel: bCreate: BOOL;

TRUE: Erzeugt und öffnet eine Datei.

Sobald das Öffnen- oder Neu-Flag gesetzt ist, werden beim nächsten Visualisierungszyklus diese Aktionen ausgeführt und der vorhandene Dateiname ausgewertet. Beide Flags werden im gleichen Zyklus ausgewertet und können daher gleichzeitig gesetzt werden.

Bearbeiten

Variable

Variable (STRING) für die Zeichenfolge, nach der in der Datei gesucht wird

Beispiel: strFind: STRING := 'abc';

Finden

Variable (BOOL) für das Durchführen der Suche nach der Zeichenfolge in Eigenschaft Variable

Beispiel: bFind: BOOL;

TRUE: Die Suche wird durchgeführt. Die Variable wird automatisch auf FALSE zurückgesetzt.

Nächstes Vorkommen finden

Variable (BOOL) um das Suchen in der Datei zu beginnen

Beispiel: bFindNext: BOOL;

TRUE: Die Suche beginnt an der letzten Fundstelle.

FALSE: Die Suche beginnt am Anfang der Datei.

Caretposition

Zeile

Variable (ganzzahliger Datentyp) für die Caret-Zeile

Beispiel: iRowCursor: INT;

Spalte

Variable (ganzzahliger Datentyp) für die Caret-Spalte

Beispiel: iColumnCursor: INT;

Position

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der absoluten Position des Carets im Text

Beispiel: iPosCursor: INT;

Cursor setzen

Variable BOOL) für das Setzen des Carets an eine bestimmte Stelle

Beispiel: iSetCursor: INT;

TRUE: Das Caret wird versetzt. Die neue Position ist in den Eigenschaften Zeile und Spalte bestimmt.

FALSE: Die Eigenschaften Zeile, Spalte und Position enthalten Istwerte.

Hinweis: Die Variable dient als Steuervariable für ein Eingabeereignis ausgelöst von einem Visualisierungsbenutzer.

Selektion

Startposition

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der absoluten Position, mit der die Textselektion beginnt

Beispiel: iPosSelection: INT;

Endeposition

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der absoluten Position, mit der die Textselektion endet

Beispiel: iPosEndSelection: INT;

Start Zeilennummer

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der Zeile, in der die Textselektion beginnt

Beispiel: iRowSelection: INT;

Start Spaltenindex

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der Spalte, in der die Textselektion beginnt

Beispiel: : iColumnSelection: INT;

Ende Zeilennummer

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der Zeile, in der die Textselektion endet

Beispiel: iRowEndSelection: INT;

Ende Spaltenindex

Ausgabevariable (ganzzahliger Datentyp) für die Ausgabe der Spalte, in der die Textselektion endet

Beispiel: iColumnEndSelection: INT;

Zu selektierende Zeile

Variable (ganzzahliger Datentyp) für die Zeilennummer, die selektiert wird

Hinweis: Die Selektion wird mit der Variablen in der Eigenschaft Selektion auslösen gesteuert.

Selektion setzen

Variable (BOOL) um die Selektion einer Zeile zu steuern

Beispiel: bSetSelection: BOOL;

TRUE: Die Zeile aus der Eigenschaft Zu selektierende Zeile wird selektiert und im Texteditor hervorgehoben dargestellt.

Wenn die Zeile nicht im aktuellen Textausschnitt des Texteditors liegt, wird der Textausschnitt an diese Zeile hin verschoben.

Fehlerbehandlung

Variable für Fehlernummer

Variable (ganzzahliger Datentyp) für die Fehlernummer im Fehlerfall

Beispiel: : iError: INT;

Die Fehlernummern sind in GVL_ErrorCodes in der Bibliothek VisuElemTextEditor deklariert. Um den englischen Fehlertext zur Fehlernummer zu erhalten, muss die Funktion VisuFctTextEditorGetErrorText() der Bibliothek aufgerufen werden.

Variable für Inhalt geändert

Variable (BOOL) für die Ausgabe der Information, ob sich der Inhalt geändert hat

Beispiel: bIsContentEdited: BOOL;

TRUE: Der Inhalt des Texteditors hat sich geändert.

Variable für Zugriffsmodus

Variable (BOOL) für das Steuern des Zugriffsrechts auf die Datei

Beispiel: bIsReadOnly: BOOL;

TRUE: Ein Visualisierungsbenutzer hat nur Lesezugriff. Zur Laufzeit wird der Dateiinhalt im Texteditor hellgrau unterlegt dargestellt.

FALSE: Ein Visualisierungsbenutzer hat Lese- und Schreibzugriff.

Maximale Zeilenlänge

Maximale Anzahl der Zeichen pro Zeile

Editiermodus

Zeichencodierung

Zeilenendzeichen

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol dargestellt und dient als Zentrum für die Rotation und die Skalierung.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Bewegung

X

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp) für den Drehwinkel in Grad

Beispiel PLC_PRG.iAngle1.

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

Skalierung

Variable (ganzzahliger Datentyp), um eine zentrische Streckung zu bewirken

Beispiel PLC_PRG.iScaling

Bezugspunkt ist die Eigenschaft Zentrum.

Der Wert 1 verkleinert das Element um den Faktor 0.001. Der Wert 1000 belässt das Element in Originalgröße.

Innere Rotation

Variable (numerischer Datentyp) für den Drehwinkel in Grad

Beispiel: PLC_PRG.iAngle2.

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol dargestellt.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Visualisierungselement wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Schaltfläche Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.