Visualisierungselement 'Texteditor'

Symbol:

Kategorie: „Spezielle Steuerelemente“

Das Element zeigt den Inhalt von Textdateien an, die auf der Steuerung gespeichert sind. Die Dateien können in ASCII oder Unicode kodiert sein.

Ein Visualisierungsbenutzer kann den Text auch editieren.

Elementeigenschaften

„Elementname“	Beispiel: `‎GenElemInst_1‎`
„Elementtyp“	„Texteditor“

Elementeigenschaft 'Position'

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

„X“	X-Koordinate der linken oberen Ecke des Elements Angabe in Pixel Beispiel: `‎10‎`
„Y“	Y-Koordinate der linken oberen Ecke des Elements Angabe in Pixel Beispiel: `‎10‎`
„Breite“	Angabe in Pixel Beispiel: `‎150‎`
„Höhe“	Angabe in Pixel Beispiel: `‎30‎`

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element an eine andere Stelle ziehen.

Siehe auch

⮫ „Element positionieren, Größe und Ebene anpassen“

Elementeigenschaft 'Schriftart'

„Schriftname“

Nicht proportionale Schriftart, mit der die Visualisierung den Dateiinhalt anzeigt.

Beispiel: „Courier New“

„Größe“

Schriftgrad

Beispiel: ‎12‎

Elementeigenschaft 'Steuervariablen'

Tab. 665: Elementeigenschaft „Steuervariablen --> Datei“
„Variable“	Variable (`‎STRING‎`). Enthält den Dateinamen und optional den Speicherort der Datei. Sie liegt auf dem Dateisystem der Steuerung. Beispiel: `‎PLC_PRG.strFile: STRING := '/Documentation/Info.txt';‎`
„Öffnen“	Variable (`‎BOOL‎`). Steuert das Öffnen der Datei, die in Eigenschaft „Variable“ bestimmt ist. Beispiel: `‎bOpen: BOOL;‎` `‎TRUE‎`: Die Datei wird geöffnet.
„Schließen“	Variable (`‎BOOL‎`). Steuert das Schließen der Datei, die in Eigenschaft „Variable“ bestimmt ist. Beispiel: `‎bClose: BOOL;‎` `‎TRUE‎`: Die Datei wird geschlossen
„Speichern“	Variable (`‎BOOL‎`). Steuert das Speichern der Datei, die in Eigenschaft „Variable“ bestimmt ist. Beispiel: `‎bStore: BOOL;‎` `‎TRUE‎`: Die Datei wird gespeichert.
„Neu“	Variable (`‎BOOL‎`). Steuert das Erzeugen einer neuen Datei. Der Name ist bestimmt in Eigenschaft „Variable“. Beispiel: `‎bCreate: BOOL;‎` `‎TRUE‎`: Erzeugt und öffnet eine Datei.

Tab. 666: Elementeigenschaft „Steuervariablen --> Bearbeiten “
„Variable“	Variable (`‎STRING‎`). Enthält die Zeichenfolge, nach der in der Datei gesucht wird. Beispiel: `‎strFind: STRING := 'abc';‎`
„Finden“	Variable (`‎BOOL‎`). Steuert 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‎`). Steuert, wo das Suchen in der Datei beginnt. Beispiel: `‎bFindNext: BOOL;‎` `‎TRUE‎`: Die Suche beginnt an der letzten Fundstelle. `‎FALSE‎`: Die Suche beginnt am Anfang der Datei.

Tab. 667: Elementeigenschaft „Steuervariablen --> Caretposition“
„Zeile“	Variable (ganzzahliger Datentyp). Enthält die Zeile des Carets. Beispiel: `‎iRowCursor: INT;‎`
„Spalte“	Variable (ganzzahliger Datentyp). Enthält die Spalte des Carets. Beispiel: `‎iColumnCursor: INT;‎`
„Position“	Ausgabevariable (ganzzahliger Datentyp). Gibt die absolute Position des Carets im Text aus. Beispiel: `‎iPosCursor: INT;‎`
„Cursor setzen“	Variable (`‎BOOL‎`). Steuert 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.

Tab. 668: Elementeigenschaft „Steuervariablen --> Selektion“
„Startposition“	Ausgabevariable (ganzzahliger Datentyp). Gibt die absolute Position, mit der die Textselektion beginnt, aus. Beispiel: `‎iPosSelection: INT;‎`
„Endeposition“	Ausgabevariable (ganzzahliger Datentyp). Gibt die absolute Position, mit der die Textselektion endet, aus Beispiel: `‎iPosEndSelection: INT;‎`
„Start Zeilennummer“	Ausgabevariable (ganzzahliger Datentyp). Gibt die Zeile, in der die Textselektion beginnt, aus. Beispiel: `‎iRowSelection: INT;‎`
„Start Spaltenindex“	Ausgabevariable (ganzzahliger Datentyp). Gibt die Spalte, in der die Textselektion beginnt, aus. Beispiel: : `‎iColumnSelection: INT;‎`
„Ende Zeilennummer“	Ausgabevariable (ganzzahliger Datentyp). Gibt die Zeile, in der die Textselektion endet, aus Beispiel: `‎iRowEndSelection: INT;‎`
„Ende Spaltenindex“	Ausgabevariable (ganzzahliger Datentyp). Gibt die Spalte, in der die Textselektion endet, aus. Beispiel: `‎iColumnEndSelection: INT;‎`
„Zu selektierende Zeile“	Variable (ganzzahliger Datentyp). Enthält die Zeilennummer, die selektiert wird. Hinweis: Die Selektion wird mit der Variablen in der Eigenschaft „Selektion auslösen“ gesteuert.
„Selektion setzen“	Variable (`‎BOOL‎`). Steuert die Selektion einer Zeile. 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. Hinweis: Die Variable dient als Steuervariable für ein Eingabeereignis ausgelöst von einem Visualisierungsbenutzer. Die Steuervariable wird nicht automatisch zurückgesetzt. Sie müssen dafür sorgen, dass das in der Visualisierung passiert.

Tab. 669: Elementeigenschaft „Steuervariablen --> Fehlerbehandlung“
„Variable für Fehlernummer“	Variable (ganzzahliger Datentyp). Enthält 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‎). Gibt aus, 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‎). Steuert das Zugriffsrecht 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.

Hinweis: Die Variable überschreibt die Einstellung in der Eigenschaft „Editiermodus“.

„Maximale Zeilenlänge“	Maximale Anzahl der Zeichen pro Zeile
„Editiermodus“	„Nur lesend“: Ein Visualisierungsbenutzer hat nur Lesezugriff auf die Datei. Zur Laufzeit wird der Dateiinhalt im Texteditor hellgrau unterlegt dargestellt. „Lesen/Schreiben“: Ein Visualisierungsbenutzer hat Lese- und Schreibzugriff.

Elementeigenschaft 'Neue Dateien'

„Zeichencodierung“	Zeichencodierung der neuen Datei: „ASCII“ „Unicode (Little endian)“ „Unicode (Big endian)“
„Zeilenendzeichen“	Zeilenendzeichen der neuen Datei: „CR/LF“: Üblich in Windows-Systemen „LF“: Üblich in Unix-Systemen Hinweis: Wenn ein Visualisierungsbenutzer eine bestehende Datei öffnet, wird das Zeilenendzeichen der Datei erkannt und automatisch verwendet.

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungsmanager die Option „Client-Animationen und Überlagerung systemeigener Elemente unterstützen“ aktiviert haben.

„Animationsdauer“

Bestimmt die Dauer in Millisekunden, in der das Element eine Animation ausführt

Variable (‎Ganzzahliger Wert‎)

Beispiel: ‎Menu.tContent‎ mit ‎VAR tContent : INT := 500; END_VAR‎
Ganzzahliges Literal

Beispiel: ‎500‎

Animierbare Eigenschaften:

„Absolute Bewegung“, „Bewegung“, „X“, „Y“
„Absolute Bewegung“, „Rotation“
„Absolute Bewegung“, „Innere Rotation“
„Absolute Bewegung“, „Äußere Rotation“

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“

Stellt das Visualisierungselement in den Vordergrund

Variable (‎BOOL‎)

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

‎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.

Siehe auch

⮫ „Client-Animation verwenden“
linktarget doesn't exist but @y.link.required='true'

Elementeigenschaft 'Zugriffsrechte'

Voraussetzung: Eine Benutzerverwaltung für die Visualisierung ist eingerichtet.

„Zugriffsrechte“

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

Statusmeldungen:

„Nicht gesetzt. Alle Rechte“: Zugriffsrecht für alle Benutzergruppen: „bedienbar“
„Rechte sind vergeben: eingeschränkte Rechte“: Mindestens für eine Gruppe ist der Zugriff eingeschränkt

Siehe auch

⮫ „Dialog 'Zugriffsrechte'“

Siehe auch

linktarget doesn't exist but @y.link.required='true'