Visualisierungselement 'Texteditor'

Symbol:

Kennzeichen: 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

Info

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

Siehe auch

Elementeigenschaft 'Schriftart'

Schriftname

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

Beispiel: Courier New

Größe

Schriftgrad

Beispiel: 12

Elementeigenschaft 'Steuervariablen'

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.

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.

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.

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.

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

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

Siehe auch

3.5.16.0

© Copyright 2021, CODESYS GmbH