Visualisierungselement 'Textfeld'
Kennzeichen: Allgemeine Steuerelemente
Das Element dient:
der statischen Ausgabe von Text. Dabei kann der Inhalt einer Variablen Teil des Textes sein.
dem Einblenden eines Tooltips. Der Text wird als statischer Text verwaltet und kann ebenfalls so definiert sein, dass der Inhalt einer Variablen mit ausgeben wird.
der dynamischen Ausgabe von Text. Dabei werden Texte einer Textliste dynamisch ausgegeben.
der Eingabe von Text. Ein Benutzer kann beispielsweise eine Zahl oder ein Textliteral eingeben.
Siehe auch
Elementname |
Optional Beispiel: FileName_A Tipp: Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden. |
Elementtyp |
Textfeld |
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
Normalzustand |
Der Normalzustand ist vorhanden, wenn die Variable in Farbvariablen ‣ Farbumschlag nicht definiert ist oder den Wert FALSE hat. |
Rahmenfarbe |
Rahmen- und Füllfarbe für den entsprechenden Zustand der Variable. |
Füllfarbe |
|
Transparenz |
Transparenzwert (255 bis 0), der die Durchsichtigkeit der zugehörigen Farbe festlegt Beispiel 255: Die Farbe ist deckend. 0: Die Farbe ist voll transparent. |
Alarmzustand |
Der Alarmzustand ist vorhanden, wenn die Variable in Farbvariablen ‣ Farbumschlag den Wert TRUE hat. |
Siehe auch
Die Eigenschaften enthalten feste Werte um das Aussehen des Elements zu setzen.
Linienstärke |
Wert in Pixel Beispiel: 2 Hinweis: Die Werte 0 und 1 führen beide zu einer Linienstärke von 1 Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein. |
Füllart |
Wie das Element gefüllt ist.
|
Linienart |
Art der Liniendarstellung
|
Info
Sie können unter der Eigenschaft Aussehensvariablen Variablen zuweisen, um das Aussehen dynamisch zu steuern. Die festen Werte hier werden dann überschrieben.
Siehe auch
Die Eigenschaften enthalten Zeichenfolgen zum Beschriften des Elements. Die Zeichenfolge kann zusätzlich einen Platzhalter mit Formatierungsangabe enthalten. Der Platzhalter wird zur Laufzeit mit dem Istwert in der angegebenen Formatierung ersetzt.
CODESYS übernimmt die eingegebenen Texte automatisch in die Textliste GlobalTextList. Somit können diese Texte lokalisiert werden.
Text |
Zeichenfolge (ohne einfache Anführungszeichen), mit dem das Element beschriftet ist. Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein. Beispiel: Accesses: %i Die Variable, die den Istwert für den Platzhalter enthält, ist in der Eigenschaft Textvariable ‣ Text angegeben. |
Tooltip |
Zeichenfolge (ohne einfaches Anführungszeichen), die als Tooltip des Elements ausgegeben wird. Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein. Beispiel: Number of valid accesses Die Variable, die den Istwert für den Platzhalter enthält, ist in der Eigenschaft Textvariable ‣ Tooltip angegeben. |
Siehe auch
Elementeigenschaft 'Texteigenschaften'
Die Eigenschaften enthalten feste Werte für die Texteigenschaften.
Horizontale Ausrichtung |
Horizontale Ausrichtung des Texts innerhalb des Elements. |
Vertikale Ausrichtung |
Vertikale Ausrichtung des Texts innerhalb des Elements. |
Textformat |
Definition, wie zu lange Texte dargestellt werden
|
Schriftart |
Beispiel: Standard
|
Farbe Schriftart |
Beispiel: Schwarz
|
Transparenz |
Ganze Zahl (Wertebereich von 255 bis 0). Sie bestimmt die Durchsichtigkeit der zugehörigen Farbe. 255: Die Farbe ist deckend. 0: Die Farbe ist voll transparent. Hinweis: Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt. |
Elementeigenschaft 'Textvariablen'
Die Eigenschaften sind Variablen, deren Inhalt eine Formatierungsangabe ersetzt.
Textvariable |
Variable (Datentyp konform mit der Formatierungsangabe). Sie enthält das, was an Stelle der Formatierungsangabe ausgegeben wird. Beispiel: PLC_PRG.iAccesses Hinweis: Die Formatierungsangabe ist Teil des Textes in der Eigenschaft Texte ‣ Text . Hinweis: Wenn Sie hier eine Variable vom Typ einer textlistenunterstützten Enumeration angeben, wird automatisch hinter dem Variablennamen in spitzen Klammern der Name des Enumerationsdatentyps hinzugefügt. Beispiel: PLC_PRG.enVar <enumeration name>. Dann erscheint bei der Textausgabe anstelle des numerischen Werts der Enumerationskomponente der symbolische Wert. Sehen Sie hierzu die Hilfeseite zu Enumerationen. |
Tooltipvariable |
Variable (Datentyp konform mit der Formatierungsangabe). Sie enthält das, was an Stelle der Formatierungsangabe ausgegeben wird. Beispiel: PLC_PRG.iAccessesInTooltip Hinweis: Die Formatierungsangabe ist Teil des Textes in der Eigenschaft Texte ‣ Tooltip . |
Siehe auch
Elementeigenschaft 'Dynamische Texte'
Dynamische Texte sind variabel indizierte Texte einer Textliste. Zur Laufzeit wird der Text ausgegeben, der aktuell in der Variablen indiziert ist.
Textliste |
Variable (String) oder Name der Textliste als fester String in einfachen Anführungszeichen. Beispiel: 'Errorlist'
|
Textindex |
Textlisten-ID. Sie verweist auf den gewünschten Ausgabetext.
|
Tooltipindex |
Textlisten-ID. Sie verweist auf den gewünschten Ausgabetext.
|
Siehe auch
Elementeigenschaft 'Schriftartvariablen'
Die Variablen ermöglichen die Darstellung der Texte dynamisch zu steuern.
Schriftname |
Variable (STRING). Enthält die Schriftart des Textes. Beispiel: PLC_PRG.stFontVar := 'Arial'; Die Auswahl an Schriftarten entspricht der im Standarddialog Schriftart. |
Größe |
Variable (Numerischer Datentyp). Enthält die Schriftgröße in Pixel oder Punkten. Die verwendete Einheit ist hinter dem Variablennamen in spitzen Klammern angegeben.
Tipp: Die Größe einer Schriftart ist in Punkten angegeben (Beispiel: Arial 12). Verwenden Sie die Einheit Punkte, wenn die variable Schriftgröße zu einer Schriftart passen soll, beispielsweise wenn in der Eigenschaft Texteigenschaft ‣ Schriftart eine Schriftart eingestellt ist. |
Flags |
Variable (DWORD). Enthält Flags für die Schriftartdarstellung. Flags:
Hinweis: Sie können die Schriftartdarstellungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein fetter und unterstrichener Text: PLC_PRG.dwFontType := 6; |
Zeichensatz |
Variable (DWORD). Enthält eine Zeichensatznummer für die Schriftart. Die Auswahl an Zeichensatznummern entspricht der Einstellung Skript des Standarddialogs Schriftart. |
Farbe |
Variable (DWORD). Enthält die Farbe des Texts. Beispiel: PLC_PRG.dwColorFont:= 16#FF000000; |
Flags für Textausrichtung |
Variable (Ganzzahliger Datentyp). Enthält die Codierung zur Textausrichtung. Beispiel: PLC_PRG.dwTextAlignment. Codierung:
Hinweis: Sie können die Textausrichtungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein vertikal und horizontal zentrierter Tex: PLC_PRG.dwFontType := 5; |
Info
Feste Werte für die Darstellung der Texte sind in Texteigenschaften gesetzt.
Siehe auch
Elementeigenschaft 'Farbvariablen'
Die Elementeigenschaft wird als Schnittstelle für Projektvariablen verwendet, um zur Laufzeit Farben dynamisch zu steuern.
Farbumschlag |
Die Eigenschaft steuert zur Laufzeit den Farbumschlag. Wertebelegung:
Zuweisungsmöglichkeiten:
|
Normalzustand Alarmzustand |
Die darunter angeordneten Eigenschaften steuern die Farbe zustandsabhängig. Der Normalzustand ist gegeben, wenn die Variable in Farbvariablen, Farbumschlag nicht definiert ist oder den Wert FALSE hat. Der Alarmzustand ist gegeben, wenn die Variable in in Farbvariablen, Farbumschlag den Wert TRUE hat. |
Rahmenfarbe |
Zuweisungsmöglichkeiten:
|
Füllfarbe |
Zuweisungsmöglichkeiten:
|
Info
Der Transparenzanteil des Farbwertes wird nur ausgewertet, wenn die Option Semitransparentes Zeichnen aktivieren des Visualisierungsmanagers aktiv ist.
Info
Aktivieren Sie in der Symbolleiste des Eigenschaftenfensters die Option Erweitert. Dann sind alle Elementeigenschaften sichtbar.
Siehe auch
Elementeigenschaft 'Absolute Bewegung'
Die Eigenschaften enthalten IEC-Variablen, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.
Bewegung |
||
X |
Variable (numerischer Datentyp). Sie enthält die X-Position in Pixel. Beispiel PLC_PRG.iPos_X. Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts. |
|
Y |
Variable (numerischer Datentyp). Sie enthält die Y-Position in Pixel. Beispiel PLC_PRG.iPos_Y. Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten. |
|
Rotation |
Variable (numerischer Datentyp). Enthält 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 Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung. |
|
Innere Rotation |
Variable (numerischer Datentyp). Enthält 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 Hinweis: Wenn in der Eigenschaft Position ‣ Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset). |
|
Info
Sie können die Variablen mit einer Einheitenumrechnung verbinden.
Info
Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität "Client-Animation" unterstützt.
Siehe auch
Elementeigenschaft 'Zustandsvariablen'
Die Variablen steuern dynamisch das Verhalten des Elements.
Unsichtbarkeit |
Variable (BOOL). Schaltet die Sichtbarkeit des Elements um. TRUE: Das Element ist zur Laufzeit nicht sichtbar. |
Eingaben deaktivieren |
Variable (BOOL). Schaltet die Bedienbarkeit des Elements um. TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt. |
Info
Die Eigenschaft Unsichtbarkeit wird von der Funktionalität "Client-Animation" unterstützt.
Siehe auch
Elementeigenschaft 'Selektions- und Caret-Konfiguration
Die Variablen ermöglichen, die Caretposition und die Selektion des Textes zu steuern.
Caretposition |
Variable (ganzzahliger Datentyp). Enthält die Position des Carets. |
Selektionsbeginn |
Variable (ganzzahliger Datentyp). Enthält die Position des ersten selektierten Zeichens. Beispiel: PLC_PRG.iSelStart |
Selektionsende |
Variable (ganzzahliger Datentyp). Enthält die Position des letzten selektierten Zeichens. Beispiel: PLC_PRG.iSelEnd |
Alles selektiert |
Variable (BOOL). Schaltet die Selektion des eingegebenen Textes um. TRUE: Der Text im Textfeld ist vollständig selektiert. FALSE: Selektion beginnt mit dem Wert in Selektionsbeginn und endet mit Selektionsende. |
Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungsmanager die Option Client-Animationen und Überlagerungen systemeigener Elemente unterstützen aktiviert haben.
Sie können eine Bewegung, eine Drehung und die Sichtbarkeit eines Visualisierungselements animieren.
Animationsdauer |
Zeit in Millisekunden, in der das Element eine Animation ausführt Beispiel: 500 |
In den Vordergrund bringen |
Eigenschaftenwert (BOOL) TRUE: Das Element wird zur Laufzeit im Vordergrund dargestellt. FALSE: Das Element wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde. |
Siehe auch
Elementeigenschaft 'Eingabekonfiguration'
Die Eigenschaften enthalten die Konfigurationen für die Benutzereingabe bei Maus- oder Tastaturbedienung. Eine Benutzereingabe definiert ein Ereignis und eine oder mehrere Aktionen, die bei Eintreten des Ereignisses ausgeführt werden.
Die Schaltfläche Konfigurieren öffnet den Dialog Eingabekonfiguration um eine Benutzereingabe zu erstellen oder zu bearbeiten. Unter den Ereignissen werden bereits konfigurierte Benutzereingaben kurz aufgelistet. Sie enthalten jeweils die Aktion, die ausgelöst wird, und in knapper Form deren Einstellung.
Beispiel: ST-Code ausführen: |
|
OnDialogClosed |
Eingabeereignis: Ein Benutzer schließt einen Dialog. |
OnMouseClick |
Eingabeereignis: Der Benutzer führt darauf einen vollständigen Mausklick aus. Er drückt die Maustaste und gibt sie wieder frei. |
OnMouseDown |
Eingabeereignis: Der Benutzer drückt die Maustaste. |
OnMouseEnter |
Eingabeereignis: Der Benutzer zieht den Mauszeiger auf das Element. |
OnMouseLeave |
Eingabeereignis: Der Benutzer zieht den Mauszeiger von einem Element weg. |
OnMouseMove |
Eingabeereignis: Der Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs. |
OnMouseUp |
Eingabeereignis: Der Benutzer lässt die Maustaste innerhalb des Elementbereichs los. |
Tasten |
Bei Auftreten eines Mausklickereignisses wird in der Applikation die unter Variable festgelegte Variable beschrieben. Die Codierung hängt von den Optionen FALSE Tasten und Beim Betreten tasten, falls Maus gefangen ab. |
Variable |
Variable (BOOL), die beim Mausklicken gesetzt wird. Beispiel: PLC_PRG.bIsTapped TRUE: Es liegt ein Mausklickereignis an. Es dauert, solange ein Benutzer die Maustaste drückt während er mit dem Mauszeiger das Element fokussiert. Es endet, wenn er die Taste freigibt. FALSE: Es liegt kein Mausklickereignis an. Voraussetzung: Die Option FALSE Tasten ist nicht aktiviert. |
FALSE Tasten |
TRUE: Es liegt kein Mausklickereignis an. FALSE: Solange das Mausklickereignis dauert. |
Beim Betreten tasten, falls Maus gefangen |
TRUE: Solange das Mausklickereignis dauert und dabei der Mauszeiger innerhalb des Elementbereichs bewegt wird. FALSE: Es liegt kein Mausklickereignis an. Oder aber der Benutzer bewegt den Mauszeiger bei gedrückter Maustaste außerhalb des Elementbereichs. Sobald der Benutzer den Mauszeiger in den Elementbereich zurückbewegt, ist der Wert wieder TRUE. Man sagt, die "Maus ist gefangen". |
Umschalten |
Bei Auftreten eines Mausklickereignisses wird die Variable gesetzt und bei Beenden des Mausklickereignisses zurückgesetzt. |
Variable |
Variable (BOOL). Ihr Wert schaltet beim Beenden des Mausklickereignisses um. Das ist, wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger im Elementbereich ist. Wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger außerhalb des Elementbereich ist, liegt kein Beenden des Mausklickereignisses vor und der Wert wird nicht umgeschaltet. Tipp: Der Benutzer kann damit eine begonnene Umschalteingabe abbrechen, indem er den Mauszeiger aus den Elementbereich zieht. |
Umschalten beim Loslassen, falls Maus gefangen |
|
Tastaturkürzel |
Tastaturkürzel auf dem Element, um bestimmte Eingabeaktionen auszulösen. Bei Eintreten des Tastaturkürzel-Ereignisses werden die unter der Eigenschaft Ereignis(se) angegebenen Eingabeaktionen ausgelöst. Dabei ist nicht die Eingabeaktion selbst angegeben, sondern das Mauseingabeereignis, das auch zu dieser Eingabeaktion führt. |
Taste |
Taste, bei deren Drücken eine Eingabeaktion folgt. Beispiel: T Hinweis: Die folgenden Eigenschaften erscheinen, wenn eine Taste ausgewählt wird. |
Ereignis(se) |
|
Umschalten |
Beispiel: Umschalt + T |
Steuerung |
Beispiel: Strg + T |
Alt |
Beispiel: Alt + T |
Info
In der Registerkarte Tastaturkonfiguration sind alle Tastaturkürzel und deren Folgeaktionen aufgelistet, die in der Visualisierung konfiguriert sind.
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:
|
Siehe auch