Lokalisierbaren Text bearbeiten

Mit Hilfe des Dialogs Lokalisierbaren Text bearbeiten können Sie dynamische Daten in einen lokalisierbaren Text einbinden:
  • Variablenwerte in unterschiedlichen Formaten
  • Andere Texte aus dem Systemmodul Sprachumschaltung
  • Datum und Uhrzeit
  • Texte aus Alarmdefinitionen oder Alarmtypdefinitionen

Das Einbinden erfolgt mit Hilfe von Formatierungsanweisungen. Eine Formatierungsanweisung in VisiWin beginnt und endet mit einem @-Zeichen und enthält Parameter, Trenn- und Formatierungszeichen. Zur Laufzeit werden die Formatierungsanweisungen aufgelöst und z. B. der aktuelle Wert der Variablen angezeigt.

example:
Text zur EntwicklungszeitAktuelle Temperatur: @1n@
Text zur LaufzeitAktuelle Temperatur: 98 °C

Um den Dialog aufzurufen, öffnen Sie eine Definition im Tabelleneditor und klicken Sie im Fenster Eigenschaftenseiten auf die Schaltfläche neben dem Parameter Text.

Im Prinzip können Sie in jeden beliebigen lokalisierbaren Text eine oder mehrere Formatierungsanweisungen einfügen. Daher steht der Dialog Lokalisierbaren Text bearbeiten in allen VisiWin Systemmodulen zur Verfügung, die mit lokalisierbaren Texten arbeiten.

Abbildung 1. Dialog Lokalisierbaren Text bearbeiten

Elemente des Dialogs

Der Dialog zum Bearbeiten eines lokalisierbaren Textes enthält folgende Bedienelemente:

Lokalisierter Text
Das Textfeld beinhaltet den lokalisierten Text inklusive der Formatanweisungen.
Vorschau
Das Textfeld zeigt den Inhalt des lokalisierbaren Textes mit interpretierten Formatanweisungen an.
Parameter
Dieser Bereich enthält optionale Parameter, die bei der Formatierung genutzt werden.
Formatierung
Dieser Bereich enthält die Formatierungsmöglichkeiten, wie dynamische Daten in lokalisierbare Texte eingebunden werden können.

Der Bereich Parameter enthält folgende Bedienelemente:

(Variable hinzufügen)
Öffnet den Dialog zur Auswahl einer Prozessvariablen. Die dort ausgewählte Variable wird als Element in die Liste Variablen aufgenommen.
(Variable entfernen)
Löscht das in der Liste Variablen selektierte Element.
(Variable nach oben verschieben)
Schiebt das in der Liste Variablen gewählte Element um einen Eintrag nach oben.
(Variable nach unten verschieben)
Schiebt das in der Liste Variablen gewählte Element um einen Eintrag nach unten.
Variablen
Enthält alle Variablennamen, deren Werte zur Laufzeit dynamisch in den Text eingebunden werden sollen.
Vorkommastellen
Legt bei numerisch einzubindenden Werten die Anzahl der Stellen vor dem Komma fest.
Nachkommastellen
Legt bei numerisch einzubindenden Werten die Anzahl der Stellen hinter dem Komma fest.
Führende Nullen
Legt bei numerisch einzubindenden Werten fest, dass die Anzahl der Stellen vor dem Komma mit führenden Nullen aufgefüllt werden.
Text/Textgruppe/Format
Je nach gewählter Formatierung bietet das Eingabefeld entweder die Möglichkeit zur Einbindung weiterer lokalisierbarer Texte oder Datums-/Zeitformatierungen. Ist die Formatierung auf Lokalisierbarer Text (fest)/Lokalisierbarer Text (variabel) eingestellt, können bestehende Texte in diesen Text eingefügt werden. Feste Texte sind dabei direkt zu übernehmen. Variable Texte können durch die Auswahl einer Textgruppe und einer Prozessvariablen eingefügt werden. Der Wert der Prozessvariablen bestimmt dabei zur Laufzeit den anzuzeigenden Text in der gewählten Textgruppe. Die Formatierungen Datums-/Zeitformat (System)/Datums-/Zeitformat (variabel) ermöglichen die Darstellung von formatierten Datums-/Zeitangaben. Das Format Datums-/Zeitformat (System) blendet zur Laufzeit die aktuelle Systemzeit in den Text ein. Über das Format Datums-/Zeitformat (variabel) wird der Wert der im Feld Parameter gewählten Prozessvariable in ein Datums-/Zeitformat umgerechnet.

Der Bereich Formatierung enthält folgende Bedienelemente:

Zahl
Bei dieser Formatierung werden die Vorgaben in den Feldern Vorkommastellen und Nachkommastellen beachtet.
Auto. Fließkomma
Stellt dynamisch eingebundene Werte (so wie sie sind) mit Nachkommastellen dar.
Wissenschaftlich
Stellt das Ausgabeformat eines dynamisch eingebundenen Wertes auf die wissenschaftliche Schreibweise.
Hexadezimal
Stellt das Ausgabeformat eines dynamisch eingebundenen Wertes auf die hexadezimale Schreibweise.
Binär
Stellt das Ausgabeformat eines dynamisch eingebundenen Wertes auf die binäre Schreibweise.
Text
Ermöglicht die Ausgabe eines Prozessvariablenwertes vom Datentyp VT_BSTR.
Lokalisierbarer Text (fest)
Ermöglicht das statische Einbinden einer anderen Textdefinition. Wird diese Einstellung als Formatierung gewählt, so wird das Eingabefeld Text/Textgruppe/Format freigeschaltet. Über die Schaltfläche öffnet sich der Dialog zur Auswahl eines Textes.
Lokalisierbarer Text (variabel)
Über die Auswahl einer Textgruppe und einer Prozessvariable wird die dynamische Einbindung von Texten ermöglicht. Über die Schaltfläche öffnet sich der Dialog zur Auswahl einer Textgruppe.
Datums-/Zeitformat (System)
Blendet zur Laufzeit die Systemzeit mit der gewählten Formatierung in den Text. Über die Schaltfläche öffnet sich der Dialog zur Auswahl eines Datums-/Zeitformates.
Datums-/Zeitformat (variabel)
Blendet zur Laufzeit den Wert der gewählten Prozessvariablen als Datums-/Zeitformat mit der gewählten Formatierung in den Text. Über die Schaltfläche öffnet sich der Dialog zur Auswahl eines Datums-/Zeitformates.
Alarmtext/Alarmtyptext
Gibt die Formatierungszeichenfolge @J@ in den lokalisierbaren Text ein.
Einfügen
Fügt die gewählte Formatierungsanweisung mit den eingestellten Parametern in den lokalisierbaren Text ein.

Dynamische Daten in einen Text einbinden

Um einen dynamischen Prozessvariablenwert in den Text einzufügen, führen Sie folgende Arbeitsschritte im Dialog Lokalisierbaren Text bearbeiten aus:

  1. Klicken Sie auf die Schaltfläche neben der (leeren) Liste Variablen. Wählen Sie im so geöffneten Dialog Variable auswählen eine Prozessvariable aus. Die gewählte Prozessvariable erscheint dann in der Liste Variablen.
  2. Wählen Sie unter Formatierung die Darstellungsart der Prozessvariable aus.
  3. Setzen Sie den Cursor im Textfeld Lokalisierter Text (oben im Dialog) an die Stelle im Text, wo der Prozessvariablenwert zur Laufzeit erscheinen soll.
  4. Klicken Sie auf Einfügen.

Es wird ein Formatblock in den Text eingefügt.

Um einen dynamischen lokalisierbaren Text in den Text einzufügen, führen Sie folgende Arbeitsschritte aus:

  1. Wählen Sie unter Formatierung die Option Lokalisierbarer Text (variabel) aus.
  2. Klicken Sie auf die Schaltfläche neben dem Feld Text/Textgruppe/Format und wählen Sie eine Textgruppe aus.
  3. Klicken Sie auf die Schaltfläche neben der Liste Variablen und wählen Sie eine Prozessvariable aus. Der Wert der hier eingestellten Prozessvariable wird zur Laufzeit zur Auswahl der Textdefinition in der gewählten Textgruppe genutzt. Das heißt aber auch, dass alle Textdefinitionen rein numerische Namen haben müssen.
  4. Setzen Sie den Cursor im Textfeld Lokalisierter Text an die Stelle im Text, wo der dynamisch umzuschaltende Text erscheinen soll.
  5. Klicken Sie auf Einfügen.

Es wird ein Formatblock in den Text eingefügt.

Formatblockauflösung

Der Formatblock setzt sich aus folgenden Bestandteilen zusammen: @ABC.D@

Beispiel: @1m4.5@

Formatzeichen Beispiel Bedeutung
@ @ Formatblock-Beginnzeichen
A 1 Ordnungsnummer der Variable in der Parameterliste
B m Formatzeichen, Ergebnis aus den Einstellungen Zahl und Führende Nullen
C 4 Vorkommastellen
. . Trennung für die Einstellung für Vor- und Nachkommastellen
D 5 Nachkommastellen
@ @ Formatblock-Endzeichen