Skip to main content

Texte ausgeben

Sie können in einem Element Text ausgeben, indem Sie in der Eigenschaft Texte → Text den Text angeben.

Sie können einen Text auch als Tooltip einblenden lassen (Elementeigenschaft Texte → Tooltip ).

Diese Texte sind statisch. Sie werden im Objekt GlobalTextList in der Ansicht POUs automatisch verwaltet und sie können während der Laufzeit der Visualisierung weder programmatisch noch über Benutzereingabe geändert werden. Sie können einen statischen Text jedoch um genau einen Platzhalter mit Formatierungsangabe erweitern, um an dieser Stelle den Inhalt einer Variablen auszugeben. Zur Laufzeit wird dann der jeweilige Istwert der Variablen ausgegeben, die Sie in der Eigenschaft Textvariable zugewiesen haben.

Tipp

Weitere Informationen zu den Formatierungsangaben siehe: Platzhalter mit Formatangabe

Wenn für den Datentyp STRING die Kodierung in UTF-8 aktiviert ist, dann sind Texte mit sprachspezifischen Zeichen erlaubt. Sowohl bei der Eingabe als auch bei der Ausgabe können Texte mit sprachspezifische Zeichen wie beispielsweise Umlautzeichen oder chinesische Schriftzeichen angegeben werden. Sie können die UTF-8-Kodierung im Dialog: Projekteinstellungen: Compile-Optionen aktivieren.

Durch dynamische Konfiguration können Sie die rein optische Textdarstellung animieren.

Die statischen Texte können Sie lokalisieren, wenn Sie im Projekt Mehrsprachigkeit eingerichtet haben.

Variablenwert dynamisch ausgeben

Das Element gibt das Ergebnis eines auf Mausklick hin ausgeführten ST-Codes als Text aus.

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Öffnen Sie die Visualisierung und fügen Sie ein Element Schaltfläche hinzu.

    Die Ansicht Eigenschaften für die neue Schaltfläche öffnet sich.

  2. Konfigurieren Sie die Eigenschaft Text: Number of clicks: %i

    Die Zeichenfolge enthält den Platzhalter %i.

  3. Deklarieren Sie in der Applikation in der POU PLC_PRG eine typkonforme Variable: iClicks : INT;

  4. Konfigurieren Sie die Eigenschaft Textvariable der Schaltfläche mit PLC_PRG.iClicks.

    Der Variablenwert wird zur Laufzeit an der Stelle des Platzhalters ausgegeben.

  5. Klicken Sie unter der Eigenschaft Eingabekonfiguration in der Zeile, die das Eingabeereignis OnMouseClick enthält, auf die Schaltfläche Konfigurieren.

  6. Wählen Sie aus der Liste der möglichen Aktionen ST-Code ausführen aus.

  7. Programmieren Sie den Code der Aktion im Editor unter ST-Code ausführen:

    PLC_PRG.iClicks := PLC_PRG.iClicks + 1;

  8. Beenden Sie den Dialog mit OK.

    Die Benutzereingabe ist konfiguriert.

  9. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich. Das Element ist beschriftet und die Anzahl der Klicks wird ausgegeben. Wenn Sie als Benutzer auf die Schaltfläche klicken, wird die Anzahl erhöht.

    _visu_img_user_input_button.png

Text aus einer Textliste dynamisch ausgeben

Sie können mit Hilfe des Elements Textfeld Text dynamisch ausgeben. Sie können über Benutzereingabe oder programmatisch eine Textausgabe implementieren.

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Öffnen Sie die Visualisierung und fügen Sie ein Element Textfeld hinzu.

    Die Ansicht Eigenschaften zeigt die Konfiguration des Elements an.

  2. Fügen Sie unter der Applikation eine Textliste mit Textlisteneinträgen hinzu: Textlist_A.

    _visu_img_textlist_a.png

  3. Deklarieren Sie in der Applikation in der POU PLC_PRG die Textvariable:strTextID : STRING := '0';

  4. Deklarieren Sie dort auch die Variable strTooltipID : STRING := '0';

  5. Deklarieren Sie dort auch die Variable iText : INT;

  6. Konfigurieren Sie die Eigenschaft Dynamische Texte → Textliste mit 'Textlist_A'.

  7. Konfigurieren Sie die Eigenschaft Dynamische Texte → Textindex mit PLC_PRG.strTextID.

  8. Konfigurieren Sie die Eigenschaft Dynamische Texte → Tooltipindex mit PLC_PRG.strTooltipID.

  9. Programmieren Sie in der Applikation in der POU PLC_PRG die CASE-Anweisung, so wie unten dargestellt.

    Die Variablen in Eigenschaft Dynamische Texte sind programmiert.

  10. Konfigurieren Sie die Eigenschaft Eingabekonfiguration → OnMouseclick für ST-Code ausführen mit PLC_PRG.iText := (PLC_PRG.iText + 1) MOD 4;

    Für das Element Textfeld ist eine Benutzereingabe konfiguriert.

  11. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich. Im Textfeld wird der Text None ausgegeben. Wenn Sie als Benutzer auf das Element klicken, wechselt der Text auf Dynamic_ File_A. Dazu wird der passesnde Tooltip ausgegeben: Information A. Mit jedem Klick wechselt der Text entsprechend der CASE-Anweisung.

    _visu_img_output_dynamic_text.png

CASE-Anweisung

CASE iText OF
    0:  strTextID := '0';
        strToolTipID := '0';

    1:  strTextID := '1';
        strToolTipID := '4';

    2:  strTextID := '2';
        strToolTipID := '5';

    3:  strTextID := '3';
        strToolTipID := '6';
ELSE
    strTextID := '0';
    strToolTipID := '0';
END_CASE;

Eingabe bei einem Textfeld konfigurieren

Damit der Benutzer in einem Textfeld Text eintragen kann, konfigurieren Sie eine Eingabe vom Typ Variable schreiben auf eine Textausgabevariable. Diese Textausgabevariable wird die Eingabe des Benutzers speichern und im Ausgabetext an Stelle des Platzhalters, das ist im Beispiel unten %s, anzeigen. Sie geben die Textausgabevariable in der Eigenschaft Textvariablen → Textvariable an.

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Deklarieren Sie in der Applikation in der POU PLC_PRG eine Stringvariable: strInput : STRING;

  2. Öffnen Sie die Visualisierung und fügen Sie ein Element Textfeld hinzu.

    Die Ansicht Eigenschaften zeigt die Konfiguration des Elements an.

  3. Konfigurieren Sie die Eigenschaft Texte → Text mit Input: %s.

  4. Klicken Sie bei der Eigenschaft Eingabekonfiguration für das Mausereignis OnMouseClick auf Konfigurieren, um den Dialog Eingabekonfiguration zu öffnen. Wählen Sie im Dialog die Aktion Variable schreiben und aktivieren Sie dafür die Option Textausgabevariable verwenden. Schließen Sie mit OK ab.

  5. Weisen Sie nun in der Eigenschaft Textvariablen → Textvariable die Textausgabevariable PLC_PRG.strInput zu.

  6. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich. Das Element gibt den Text aus: Input:. Klicken Sie auf das Element. Dann erscheint ein Eingabefeld, in dem Sie eine Zeichenfolge eingeben können. Wenn Sie die Eingabe mit Eingabe beenden, wird der Text übernommen.

    _visu_img_current_imput.png

Ausgabe in einem Textfeld konfigurieren

Sie können das Element Textfeld in ihre Visualisierung verwenden, um darin Text auszugeben oder dem Benutzer eine Eingabemöglichkeit auf diese Variable bereitzustellen.

Außerdem können Sie eine Texteingabe konfigurieren. Dann erscheint auf eine Benutzereingabe hin im Fensterbereich des Elements Textfeld ein Eingabefeld. Notwendig dafür ist, dass Sie in der Eigenschaft Eingabekonfiguration eine Benutzereingabe konfigurieren.

Text als Tooltip einblenden

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Öffnen Sie die Visualisierung und fügen Sie ein Element Textfeld hinzu.

    Die Ansicht Eigenschaften zeigt die Konfiguration des Elements an.

  2. Konfigurieren Sie die Eigenschaft Texte → Text : File name: %s

    Der Text enthält den Platzhalter %s

  3. Konfigurieren Sie die Eigenschaft Texte → Tooltip : Storage location: %s

  4. Deklarieren Sie in der Applikation in der POU PLC_PRG eine typkonforme Variable strFileName : STRING := 'File_A';

  5. Deklarieren Sie in der Applikation in der POU PLC_PRG die Variable strFileDir : STRING := 'D:/Data';

  6. Konfigurieren Sie die Eigenschaft Textvariable des Textfelds mit PLC_PRG.strFileName.

    Der Inhalt der Variablen wird zur Laufzeit an der Stelle des Platzhalters ausgegeben.

  7. Konfigurieren Sie die Eigenschaft Tooltip des Textfelds mit PLC_PRG.strFileDir.

  8. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich. Das Element gibt den Text File name: File_A aus. Wenn der Mauszeiger über das Textfeld bewegt wird, erscheint der Tooltip: Storage location : D/Data.

    _visu_img_output_text.png

Animieren der Textdarstellung

Eine Animation der Darstellung von Text können Sie in der Eigenschaft Schriftartvariablen konfigurieren. Alle Basiselemente verfügen über diese Eigenschaft, außerdem noch Tabellen, Scrollbalken, und Textfelder.

Prozedur. Beispiel: Schriftartgröße animieren

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Öffnen Sie die Visualisierung und fügen Sie ein Element Rechteck hinzu.

    Die Ansicht Eigenschaften zeigt die Konfiguration des Elements an.

  2. Konfigurieren Sie die Eigenschaft Texte → Text mit Important.

  3. Deklarieren Sie in der Applikation in der POU PLC_PRG eine typkonforme Variablen:

    iFontHeight : INT;

  4. Konfigurieren Sie die Eigenschaft Schriftartvariablen → Größe mit PLC_PRG.iFontHeight.

  5. Implementieren Sie eine Änderung der Größe der Schriftart.

    iFontHeight := iFontHeight + 1) MOD 20;

  6. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich. Das Rechteck ist mit Important beschriftet. Die Schriftgröße wächst von 1 auf 20 an.

Beschriften

Sie können Informationen mit dem Element Beschriftung ausgeben.

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet.

  1. Öffnen Sie die Visualisierung und fügen Sie ein Element Beschriftung hinzu.

    Die Ansicht Eigenschaften mit dessen voreingestellten Eigenschaften öffnet sich.

  2. Konfigurieren Sie die Eigenschaft Texte → Text : Visualization A.

Für weitere Informationen siehe: Beschriftung

Element ausblenden

Sie können die Eigenschaft Zustandsvariable → Unsichtbarkeit konfigurieren, um ein Element auszublenden.

Voraussetzung: Sie haben in der Visualisierung ein Textfeld, das nur eingeblendet wird, wenn eine bestimmte Applikationsvariable TRUE wird. Beispielsweise um nur bei einem bestimmten Zustand eine Anweisung oder Erklärung dazu anzuzeigen.

  1. Konfigurieren Sie für das Textfeld die Eigenschaft Texte → Text mit Error detected: Do the following....

    Konfigurieren Sie die Eigenschaft Texteigenschaft → Farbe Schriftart mit Dunkelrot.

  2. Deklarieren Sie in PLC_PRG die Variable bIsInvisible : BOOL := TRUE;

    Die Initialisierung hier ist für das Beispiel. Ansonsten wird die Variable vom Applikationsprogramm unter bestimmten Bedingungen auf TRUE gesetzt.

  3. Konfigurieren Sie die Eigenschaft Zustandsvariablen → Unsichtbarkeit mit PLC_PRG.bIsInvisible.

  4. Übersetzen, laden und starten Sie die Applikation.

    Die Applikation läuft. Die Visualisierung öffnet sich und das Textfeld ist nicht sichtbar. Wenn Sie bIsInvisible nun auf TRUE setzen, erscheint das Textfeld.

Text mit Abstand zum Elementrahmen ausrichten

Elemente mit der Elementeigenschaft Horizontale Ausrichtung oder Vertikale Ausrichtung können ihren Text nicht nur vertikal oder horizontal ausrichten, sondern über ihren Stil den Text so ausrichten, dass der Text mit einem Abstand in Pixel zum Elementrand angezeigt wird.

Definieren Sie in Ihrem Stil zusätzlich folgende Stileigenschaften:

Abbildung 1. Stileigenschaft für Textausrichtung mit Abstand
Stileigenschaft für Textausrichtung mit Abstand


Das betrifft folgende Elemente:

Der Abstandswert wird nur angewendet, wenn die Ausrichtung nicht zentriert wird.

Beispiel 6. Beispiel: Visualisierungsstil Test for text field margin
_visu_example_style_margin.png


In diesem Abschnitt: