Skip to main content

Text in Textlisten erstellen und dynamisch ausgeben

Eine Textliste kann mehrere Sprachen definiert haben, um die Standardtexte in diese zu übersetzen. Über eine Eingabekonfiguration ist es dann möglich, die Visualisierung in eine andere Sprache umzuschalten.

Texte, die gemeinsam in einer Textliste definiert sind, können in einem Visualisierungselement nacheinander ausgegeben werden. Eine solche dynamische Textausgabe basiert auf einer sich ändernden ID in der Elementeigenschaft Textindex des Visualisierungselements. Immer wenn sich die ID ändert, wird die Textausgabe auf den neu referenzierten Text geändert. Das Element, das für die Textausgabe vorgesehen ist, benötigt als initiale Textreferenz in der Eigenschaft Textliste den Namen der Textliste und in der Eigenschaft Textindex eine Variable für die ID des Textlisteneintrags. Der Variablenwert kann dann im Applikationscode auf eine andere ID gesetzt werden.

In der folgenden Schritt-für-Schritt-Anleitung wird ein Text dynamisch in einem Rechteck-Element ausgegeben. Es ist aber auch möglich, Texte in einem Alarmelement auszugeben. Die programmatische Mechanik ist die gleiche.

Textliste erstellen

Zuerst muss eine Textliste mit mehreren Einträgen und mehreren Sprachen erstellt werden.

Voraussetzung: Ein Projekt mit Visualisierung ist geöffnet.

  1. Selektieren Sie im Gerätebaum eine Applikation und wählen Sie den Befehl Projekt → Objekt hinzufügen.

  2. Wählen Sie das Objekt Textliste aus und geben Sie dem neuen Objekt einen Namen.

    TextList_A

    Hinweis: Eine Textliste kann global in der POUs-Ansicht oder unter einer Applikation im Gerätebaum liegen.

  3. Beenden Sie den Dialog mit Hinzufügen.

    Das neue Objekt ist angelegt und erscheint als leere Liste im Editor.

  4. Klicken Sie in der Textliste unter die Spalte Standard, so dass sich ein Eingabefeld öffnet. Geben Sie einen Text ein.

    Text for A

    Der Standardtext ist erstellt. Unter der ID-Spalte erscheint automatisch eine 0. Die ID dient als Schlüssel in der Tabelle und der Standardtext als Ausgangstext für Übersetzungen.

  5. Geben Sie in der Spalte ID für den neuen Text eine von Ihnen gewünschte ID an.

    A

    Ein Textlisteneintrag ist definiert.

  6. Doppelklicken Sie in die leere Zeile am unteren Ende der Tabelle unter Standard und definieren Sie weitere Textlisteneinträge.

  7. Fügen Die der Textliste die Sprachen de, en und it.

    Weitere Informationen dazu finden Sie in der Hilfe für den Befehl Sprache hinzufügen.

  8. Übersetzen Sie die Standardtexte.

    In der Textliste TextList_A sind nun mehrere Einträge mit eindeutiger ID, den gewünschten Standardtexten und den zugehörigen Übersetzungen in Deutsch, Englisch und Italienisch vorhanden.

    _vsprt_img_configuring_dynamic_text.png

    Die Textliste kann nun verwendet werden, um einen Text dynamisch auszugeben oder die Sprache umzuschalten.

Text dynamisch ausgeben

Wenn die Textliste vorhanden ist, müssen die für die Ausgabe und die Sprachumschaltung benötigten Variablen im Applikationscode deklariert werden. Außerdem muss ein Visualisierungselement für die Ausgabe initialisiert werden. Danach können die Variablen und die Visualisierung nach Bedarf programmiert werden.

Voraussetzung: Ein Projekt ist geöffnet und eine Textliste ist vorhanden.

  1. Programmieren Sie in ihrem Applikationscode die Variable PLC_PRG.sTextId des Typs STRING.

  2. Fügen Sie eine neue Visualisierung unter ihrer Applikation hinzu.

    Im Visualisierungseditor erscheint eine leere Visualisierung

  3. Ziehen Sie ein Visualisierungselement Rechteck in die Visualisierung. Diese Rechteck dient der Textausgabe.

  4. Konfigurieren Sie für das neue Rechteck unter der Eigenschaftenkategorie Dynamische Texte die Eigenschaften.

    Achten Sie bei der Eingabe der Werte auf die Hochkommata. Es wird sowohl bei der Textliste als auch beim Textindex ein Stringliteral erwartet. Sie können alternativ eine IEC-Variable des Typs STRING zuweisen.

    Wenn Sie in eines der Eingabefelder (Spalte Wert) doppelklicken, erhalten Sie Unterstützung. Bei der Textliste ist es eine Auswahlliste mit den im Projekt definierten Textlisten. Beim Textindex ist es die Eingabehilfe für Projektvariablen.

    1. Eigenschaft Textliste: 'TextList_A'

    2. Eigenschaft Textindex: Variable PLC_PRG.sTextId

  5. Fügen Sie der Visualisierung weitere 3 Rechtecke hinzu. Diese Rechtecke dienen der Sprachumschaltung.

    1. Konfigurieren Sie das erste wie folgt:

      Eigenschaft Text: de

      Eigenschaft Eingabekonfiguration > OnMouseDown > Sprachumschaltung > de

    2. Konfigurieren die das zweite wie folgt:

      Eigenschaft Text : en

      Eigenschaft Eingabekonfiguration > OnMouseDown > Sprachumschaltung > en

    3. Konfigurieren Sie das dritte wie folgt

      Eigenschaft Texte : it

      Eigenschaft Eingabekonfiguration > OnMouseDown > Sprachumschaltung > it

  6. Übersetzen Sie die Applikation, laden Sie sie auf die Steuerung und starten Sie sie.

    Als Visualisierungsbenutzer können Sie mit Klick auf ein Sprach-Rechteck die Sprache umschalten.

    Im Onlinebetrieb können Sie das Programm PLC_PRG monitoren und die Variable sTextId mit den Werten 'A', 'B' oder 'C forcen.

    Weiter Informationen finden Sie unter: Forcen und Schreiben von Variablen

    _vsprt_img_dynamic_text_in_run.png
In diesem Abschnitt: