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 finden Sie unter Platzhalter mit FormatangabePlatzhalter 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.

Bildelement mit einem statischen Text beschriften

Voraussetzung: Ein Projekt mit einer Visualisierung ist geöffnet. Sie haben eine Bilddatei für ein Stoppsymbol.

  1. Fügen Sie unter der Applikation ein Objekt Bildersammlung mit dem Namen ImagePool_A ein.

  2. Fügen Sie der Bildersammlung ImagePool_A das Bild aus Ihrer Bilddatei mit der ID Stop hinzu.

    _visu_img_element_image_stop.png
  3. Öffnen Sie die Visualisierung und ziehen Sie ein Element Bild in den Editor.

    Die Eingabeunterstützung öffnete sich. Im Reiter Kategorie ist die Bildersammlung ImagePool_A aufgelistet.

  4. Selektieren Sie das Bild Stop und beenden Sie den Dialog mit OK.

  5. Konfigurieren Sie dessen Eigenschaft Text: ImagePool_A, Stop

  6. Konfigurieren Sie die Eigenschaft Texteigenschaften → Horizontale Ausrichtung : Links.

  7. Konfigurieren Sie die Eigenschaft Texteigenschaften → Vertikale Ausrichtung : Unten.

    _visu_img_element_image_stop_labeled.png

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;                    

Text statisch ausgeben

Sie können in Texte → Text einen Text definieren, um ihn statisch auszugeben. Ein Text in Texte → Tooltip wird als Tooltip eingeblendet. Sie können den Text so konfigurieren, dass dabei der Inhalt einer Variablen mit ausgeben wird.

Sie können einen statischen Text um (genau) einen Platzhalter mit Formatierungsangabe erweitern, um an dieser Stelle zur Laufzeit den Inhalt einer Variablen auszugeben. Ausgegeben wird die Variable, die Sie in der Eigenschaft Textvariable zugewiesen haben. Wenn die Variable sich im Applikationscode ändert, dann ändert sich zeitgleich deren Ausgabe in der Visualisierung.

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. Deklarieren Sie in der Applikation in der POU PLC_PRG eine typkonforme Variable strFileName : STRING := 'File_A';

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

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

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

    Die Applikation läuft. Die Visualisierung öffnet sich. Das Element gibt den Text aus: File name: File_A

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