Skip to main content

Mehrsprachigkeit einrichten

Texte und Tooltip-Texte für Visualisierungen werden in Textlisten verwaltet und können in verschiedenen Landessprachen bereitgestellt werden. Zur Umschaltung einer Visualisierung zwischen den vorhandenen Sprachen konfigurieren Sie ein Visualisierungselement mit der Eingabekonfiguration für Sprachumschaltung.

Statische Texte werden automatisch im Objekt GlobalTextList verwaltet. Dynamische Texte werden in explizit angelegten Textlisten verwaltet.

Ein dynamischer Text kann zur Laufzeit über eine Variable geändert werden, die einen Textlisteneintrag indiziert. Dynamische Texte werden oft zur Ausgabe von Variablenwerten oder Fehlermeldungen verwendet.

Statische Texte sind feste Strings, die z. B. für Beschriftungen verwendet werden.

Für weitere Informationen siehe: Sprachen und Übersetzungen verwalten

Anmerkung

Damit Unicode-Zeichen dargestellt werden, muss im Objekt Visualisierungsmanager auf der Registerkarte Einstellungen die Option Unicode-Zeichenfolgen verwenden aktiviert sein.

Tipp

Aussehen und Formatierung von Texten und Tooltips können Sie über die Elementeigenschaften Texteigenschaften und Schriftartvariablen beeinflussen.

Sprachumschaltung für Texte aus Textlisten konfigurieren

Clientabhängige Sprache

Die Sprache kann für jeden Client individuell umgeschaltet werden. Voraussetzung ist, dass das Add-on CODESYS Visualization mindestens in der Version 4.7.0.0 und das Laufzeitsystem in einer Version >= V3.5 SP20 installiert ist. Beim Start der Visualisierung wird diese in der im Browser eingestellten Sprache angezeigt (z. B. de, en). Diese Sprache muss im Projekt vorhanden sein. Ist die Sprache nicht vorhanden, werden die Standardtexte angezeigt.

Bis zur Version 4.6.0.0 erfolgte die Sprachumschaltung für alle Clients gleichzeitig. 

Voraussetzung: Im Projekt ist ein leeres Visualisierungsobjekt eingefügt und im Visualisierungseditor zur Bearbeitung geöffnet. Ebenfalls gibt es bereits ein Objekt Visualisierungsmanager. Für die Visualisierung ist keine Benutzerverwaltung angelegt.

Die folgende Anleitung zeigt ein sehr vereinfachtes Beispiel:

  • Mit Hilfe von zwei Schaltflächen soll der Benutzer die Texte der Visualisierung zwischen Deutsch und Englisch umschalten können.

  • In der Visualisierung gibt es als statische Texte die Beschriftungen „Zustand Maschine 01“, „Zustand Maschine 02“, „Deutsch“ und „Englisch“. Diese Texte werden in GlobalTextList in deutsch und englisch bereitgestellt.

    Dynamische Texte werden den Zustand der beiden Maschinen beschreiben. Die Texte werden in der Textliste Status_Texts in den Sprachen Deutsch (de) und Englisch (en) bereitgestellt.

  1. Ziehen Sie aus der Ansicht Visualisierungswerkzeuge aus Kategorie Allgemeine Steuerelemente ein Textfeld ins Editorfenster. Tragen Sie im Eigenschafteneditor für die Elementeigenschaft Texte → Text den Wert State, Machine M01 ein.

  2. Kopieren Sie das Element und ändern in der Kopie den Beschriftungstext auf State, Machine M02.

  3. Sehen Sie für die folgenden Schritte auch die Abbildung bei Schritt 14.

    Fügen Sie im Visualisierungseditor aus der Ansicht Visualisierungswerkzeuge, Kategorie Allgemeine Steuerelemente zwei Elemente des Typs Schaltfläche ein. Über diese Elemente soll der Benutzer später die Landessprache der Visualisierung umschalten können soll. Tragen Sie im Eigenschafteneditor bei Elementeigenschaft Texte → Text (4) den Text German beziehungsweise English ein.

  4. Öffnen Sie GlobalTextList in der Ansicht POUs mit einem Doppelklick.

    Der Texte sind in Spalte Standard (1) eingetragen, die IDs 0 und 1 werden automatisch vergeben und rein informativ dargestellt.

  5. Fügen Sie die Sprachen "de" und "en" hinzu und lokalisieren Sie die Standardtexte mit den in der folgenden Abbildung angezeigten Lokalisierungstexten.

    Sprachkürzel

    Verwenden Sie den ISO-639-Code (z. B. de, en, it, zh-CHS), um eine in der Visualisierung vorhandene Sprache zu benennen.

    _visu_img_localization_globaltextlist.png
  6. Schließen Sie das GlobalTextList-Objekt.

  7. Fügen Sie im Visualisierungseditor aus der Ansicht Visualisierungswerkzeuge, Kategorie Basis zwei Elemente des Typs Rechteck ein, in dem jeweils der aktuelle Zustand der jeweiligen Maschine angezeigt werden soll.

  8. Zur Verwaltung der zustandsbeschreibenden Texte fügen Sie unter der Applikation ein Objekt des Typs Textliste ein. Nennen Sie die Liste Status_Texts.

  9. Tragen Sie im Editor von Status_Texts die in der Abbildung gezeigten Texte für die Standardsprache (1) und die Zielsprachen de und en ein.

    _visu_img_localization_textlist.png
  10. Schließen Sie die Textliste Status_Texts.

  11. Selektieren Sie das Rechteck-Element zur Anzeige des Zustands für Maschine M01. Wählen Sie im Eigenschafteneditor (2) für die Elementeigenschaft Dynamische Texte (5) aus der Combobox die Textliste Status_Texts. Tragen Sie bei Textindex eine Applikationsvariable ein, die zur Laufzeit die zum Zustand der Maschine passende Textindex liefert. Beispiel: PLC_PRG.ivar_status_m01.

  12. Nun konfigurieren Sie noch die Benutzereingabe für die beiden Schaltflächen zum Umschalten der Landessprache in der Visualisierung.

    Selektieren Sie die Schaltfläche „German“. Doppelklicken Sie bei Eigenschaft Eingabekonfiguration (6), OnMouseClick: auf Konfigurieren.

    Der Dialog Eingabekonfiguration / OnMouseClick erscheint.

  13. Selektieren Sie links Sprachumschaltung. Klicken Sie auf die Pfeilschaltfläche, um die Einstellung nach rechts zu übernehmen. Wählen Sie dann rechts im Dialog bei Sprache in der _cds_icon_input_assistent.png Eingabeunterstützung de aus. Bestätigen Sie mit OK.

  14. Konfigurieren Sie auf gleiche Weise die Eingabe für die zweite Schaltfläche, also English: Textliste: Status_Texts, Textindex: 3, Sprachumschaltung: English).

    Die folgende Abbildung zeigt die vorgenommenen Eigenschaftenkonfigurationen für die vier Visualisierungselemente.

    _visu_img_localization_example.png
  15. Wenn Ihre Applikation fehlerfrei übersetzbar ist, können Sie nun die Visualisierung im Simulationsbetrieb testen. Aktivieren Sie die Option Online → Simulation . Wählen Sie den Befehl Online → Einloggen .

    Die Visualisierung erscheint im Visualisierungseditorfenster im Onlinebetrieb:

    _visu_img_loc_example_online_en.png
  16. Klicken Sie auf die Schaltfläche German.

    Die Sprache wechselt zu Deutsch:

    _visu_img_loc_example_online_de.png

Für weitere Informationen siehe: Sprachumschaltung

Schriftart für eine Sprache einstellen

Die Schriftart eines Visualisierungselements ist im Eigenschafteneditor definiert. Wenn eine Sprachumschaltung vorgesehen ist, können Sie diese Basisschriftart im Visualisierungsmanager für jede Landessprache mit einer anderen überschreiben.

Voraussetzung: Sie haben für eine Visualisierung wenigstens eine Landessprache außer der Standardsprache eingerichtet.

Ein Beispiel finden Sie unter Sprachumschaltung für Texte aus Textlisten konfigurieren

  1. Öffnen Sie mit einem Doppelklick das Objekt Visualisierungsmanager und wählen die Registerkarte Schriftart.

  2. Führen Sie für die betreffende Sprache in der Zeile Schriftart einen Doppelklick auf das Feld aus. Wählen Sie aus der Combobox die gewünschte Schriftart aus.

  3. Ersetzen Sie in der Zeile Schriftgrad den Wert 1 durch beispielsweise 2 (also größer 1), um die durch den Visualisierungsstil vorgegebene Größe des Schriftgrads zu verdoppeln; oder Sie ersetzen ihn durch beispielsweise 0.5 (also kleiner 1), um die Größe zu halbieren.

    Im Onlinebetrieb wechselt das Schriftbild je nach eingestellter Landessprache.