Visualisierungselemente konfigurieren
'Extras' 'Konfigurieren'
Mit diesem Befehl öffnet sich der Dialog 'Element konfigurieren' zum Konfigurieren des selektierten Visualisierungselements. Den Dialog erhalten Sie auch durch Doppelklick auf das Element. Wählen Sie im linken Bereich des Dialogs eine Kategorie aus und füllen Sie im rechten Bereich die gewünschten Angaben aus. Dies geschieht entweder durch Aktivieren bestimmter Optionen oder durch Eintragen einer gültigen Variablen, deren Wert die Eigenschaft bestimmt. Für die verschiedenen Elementtypen sind unterschiedliche Konfigurationskategorien verfügbar.
Auch für eine Gruppe von Elementen stehen Konfigurationsdialoge zur Verfügung. Die Eigenschaften beziehen sich dann jedoch nur auf das "Element" Gruppe. Um die Einzelelemente konfigurieren zu können, muss die Gruppe aufgelöst werden.
Bei Eigenschaften, die sowohl über eine feste Einstellung, wie auch durch eine Variable bestimmt werden, gilt später im Online Modus, dass der Variablenwert den der festen Einstellung überschreibt (Beispiel: "Alarmfarbe innen" kann in Kategorie 'Farben' statisch, in Kategorie 'Farbvariablen' zusätzlich dynamisch über eine Variable definiert werden). Wird die Einstellung zusätzlich noch über eine Strukturvariable angesteuert, wird deren Wert ebenfalls durch die im Konfigurationsdialog eingetragene Projektvariable überschrieben.
 | Zeigerinstrument, Balkenanzeige und Histogramm müssen vor der Konfiguration neu gruppiert werden. |
An den Stellen in der Element-Konfiguration, an denen Variablen wirksam werden, sind folgende Eingaben möglich:
- Variablennamen, wobei die Eingabehilfe (<F2>) zur Verfügung steht
- Ausdrücke, die zusammengesetzt sind aus Komponentenzugriffen, Feldzugriffen mit konstantem Index, Variablen und direkten Adressen
- Operatoren und Konstanten, die zusammen mit den bisherigen Ausdrücken beliebig kombiniert werden können
- Platzhalter anstelle von Variablennamen oder Textstrings
Beispiele für zulässige Ausdrücke:
x + y
100*PLC_PRG.a
TRUE
NOT PLC_PRG.b
9*sin(x + 100)+cos(y+100)
Nicht möglich sind Funktionsaufrufe. Unzulässige Ausdrücke führen beim Einloggen zu einer Fehlermeldung ("Fehlerhafter Watchausdruck ..").
Beispiele für nicht zulässige Ausdrücke:
fun(88)
a := 9
RETURN.
Für globale Variablen sind in diesen Konfigurationsdialogen zwei Schreibweisen möglich: ".globvar" und "globvar" sind gleichbedeutend. Die Schreibweise mit Punkt (entspricht der, die im Watch- und Rezepturverwalter verwendet wird) ist allerdings nicht innerhalb eines zusammengesetzten Ausdrucks möglich.
Winkel
Im Dialog zum 'Kreissektor konfigurieren' können Sie in der Kategorie Winkel jeweils einen Wert oder eine Projektvariable eintragen, die Anfangswinkel und Endwinkel des Kreisssektor-Elements in Winkelgraden definieren. Wenn die Option Nur Kreisbogen anzeigen aktiviert ist, wird der nur der Kreisbogen dargestellt.
Beispiel: Eingabe für Anfangswinkel: "90", Endwinkel: "180"
Dialog zum Konfigurieren von Kreissektoren
Form
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Form zwischen Rechteck, Abgerundetes Rechteck, Ellipse und Linie bzw. Polygon, Linienzug und Kurve wählen. Die Form wechselt in der bereits festgelegten Größe.
Dialog zum Konfigurieren von Visualisierungselementen
Text
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Text)
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Text einen Text für das Element festlegen. Dieser wird direkt eingegeben oder/und es wird eine Variable festgelegt, die ihn liefert. Die Verwendung von Platzhaltern ist dabei möglich. Die Grundeinstellungen für Schrift und Ausrichtung werden ebenfalls definiert.
Wenn Textparameter, die im vorliegenden Dialog statisch definiert sind, zusätzlich dynamisch, d.h. über Variable (s.u. Kategorie 'Textvariablen' bzw. 'Programmierfähigkeit') geliefert werden, werden die statischen Definitionen überschrieben.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Geben Sie den Text direkt in das Feld Inhalt ein. Durch die Tastenkombination <Strg>+<Eingabetaste> können Sie Zeilenumbrüche einfügen, mit <Strg>+<Tabulator> Tabstops. Zusätzlich zu der reinen Eingabe von Texten haben Sie folgende Formatierungsmöglichkeiten:
- Wenn Sie im Text "%s" eingeben, wird im Online-Modus an dieser Stelle der Wert der Variablen aus dem Feld 'Textausgabe' der Kategorie 'Variablen' als String dargestellt. Sie können auch eine Formatangabe verwenden, die der der Funktion sprintf aus der Standard-C-Bibliothek entspricht:
Mögliche Zeichenformatierungen:
Zeichen | Argument / Ausgabe als |
|---|---|
d,i | Dezimale Zahl |
o | Oktale Zahl ohne Vorzeichen (ohne führende Null) |
x | Hexadezimale Zahl ohne Vorzeichen (ohne führendes 0x) |
u | Dezimale Zahl ohne Vorzeichen |
c | Einzelnes Zeichen |
s | Zeichenkette |
f | REAL-Werte [-]m.<dddddd>, wobei die Genauigkeit die Anzahl der d festlegt (Voreinstellung ist 6). Das Plus- bzw. Minuszeichen definiert Rechts (Voreinstellung) bzw. Linksbündigkeit, m gibt die Anzahl der gesamten Stellen an |
Der Variablenwert wird im Online-Modus entsprechend dargestellt werden. Als Eingabe sind alle IEC-konformen Formatierungen erlaubt, die zum jeweiligen Typ der Variable passen.
| Es findet keine Überprüfung statt, ob der in der Formatangabe angegebene Typ zu dem der in 'Textausgabe' eingetragenen Variablen passt. |
Beispiel:
Eingabe im Feld Inhalt: Füllstand %2.5f cm
Eingabe im Feld Textausgabe z.B.: fvar1 (REAL Variable)
-> Ausgabe im Online Modus z.B.: Füllstand 32.48999 cm
• Wenn Sie im Text "%t", gefolgt von einer bestimmten Folge von speziellen Platzhaltern, eingeben, wird diese Stelle im Online Modus durch die Angabe der Systemzeit ersetzt: Die Platzhalter definieren das Format der Ausgabe; sehen Sie die untenstehende Tabelle.
Vor %t darf kein weiteres Zeichen eingegeben werden (im Gegensatz zu z.B. "%s", s.o.)
Platzhalter | Format |
|---|---|
%a | Name des Wochentags, abgekürzt, z.B. "Wed" |
%A | Name des Wochentags, volle Länge, z.B. "Wednesday" |
%b | Monatsname, abgekürzt, z.B. "Feb" |
%B | Monatsname, volle Länge, z.B. "February" |
%c | Datum und Uhrzeit im Format <Monat>/<Tag>/<Jahr> <Stunden>:<Minuten>:<Sekunden>, z.B. "08/28/02 16:58:45" |
%d | Monatstag als Zahl (01-31), z.B. "24" |
%H | Stundenangabe, 24-Stundenformat (01-24), z.B. "16" |
%I | Stundenangabe, 12-Stundenformat (01-12), z.B. "05" für 17 Uhr |
%j | Tag des Jahres (001 – 366), z.B. "241" |
%m | Monat (01 – 12), z.B. "3" für März |
%M | Minuten (00 – 59), z.B. "13 |
%p | Aktueller Anzeiger AM (Stunden <12) bzw. PM (>12) für die Angabe im 12-Stundenformat, z.B. "AM", wenn es gerade 9 Uhr vormittags ist. |
%S | Sekunden (00 – 59) |
%U | Wochenangabe als Zahl, wobei Sonntag als erster Tag der Woche gerechnet wird) (00 – 53 für 53 mögliche Wochen eines Jahres) |
%w | Wochentag als Zahl (0 – 6; Sonntag = 0) |
%W | Wochenangabe als Zahl, wobei Montag als erster Tag der Woche gerechnet wird) (00 – 53 für 53 mögliche Wochen eines Jahres) |
%x | Datum im Format <Monat>/<Tag>/<Jahr>, z.B. "08/28/02" |
%X | Uhrzeit im Format <Stunden>:<Minuten>:<Sekunden>, z.B. "16:58:45" |
%y | Jahresangabe ohne Jahrhunderte (00 – 99), z.B. "02" |
%Y | Jahresangabe mit Jahrhunderten, z.B. "2002" |
%z, %Z | Angabe der Zeitzone (keine Angabe, falls die Zeitzone nicht bekannt ist), z.B. "Westeuropäische Sommerzeit" |
%% | Prozentzeichen |
Beispiele:
%t%a %b %d.%m.%y %H:%M:%S
-> Ausgabe im Online Modus: Wed Aug 28.08.02 16:32:45
Zwischen den Platzhaltern kann auch ein Text eingegeben werden:
%tHeute ist der %d.%m.%y
-> Ausgabe im Online Modus: Heute ist der 28.08.02
Soll ein Textstring in eine Übersetzungsdatei übernommen werden, die dann im Online Modus ein Umschalten in eine andere Landessprache ermöglicht, muss er am Anfang und am Ende mit # begrenzt werden. Beispiele: „#Pumpe 1#" oder aber auch „#Pumpe# 1" Der letztere Fall beispielsweise erspart beim mehrmaligen Vorkommen des Textes Pumpe (Pumpe 1, Pumpe 2 etc.) ein mehrmaliges Auftreten in der Übersetzung.
• Wenn Sie im Text "%<PREFIX>" eingeben, können Sie anstelle von "PREFIX" eine beliebige Buchstabenfolge eingeben, die für die Verwendung von dynamischen Texten als Kennzeichner dient. Das Prefix wird dazu in Kombination mit einer ID verwendet, die wiederum über den Eintrag in Kategorie 'Variablen' im Feld 'Textausgabe' festgelegt wird. Die Kombination verweist auf eine bestimmte Textversion, die in einer XML-Datei vorliegt, welche die möglichen dynamischen Texte definiert. Somit wird zur Laufzeit jeweils der zur aktuellen Kombination gehörige Text angezeigt.
Der konfigurierte Text wird online je nach angegebener Ausrichtung Horizontal Links, Zentriert oder Rechts und Vertikal Oben, Zentriert oder Unten im Element erscheinen.
Mit der Schaltfläche Schrift erscheint der Dialog zu Auswahl der Schriftart. Wählen Sie die gewünschte Schriftart und Bestätigen Sie den Dialog mit OK. Mit der Schaltfläche Standard-Schrift wird die Schriftart eingestellt, die in den Projektoptionen ('Projekt' 'Optionen' 'Editor') gewählt ist. Wird sie dort verändert, wird in allen Elementen diese Schriftart angezeigt, außer bei Elementen, bei denen explizit eine andere über die Schaltfläche Schrift gewählt wurden.
Textvariablen
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Textvariablen)
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Textvariablen für die in der Kategorie 'Text' eingegebene Zeichenfolge definieren, über welche Projektvariable Farbe und Font-Eigenschaften dynamisch bestimmt werden sollen. Geben Sie dazu den Variablennamen am besten über die Eingabehilfe <F2> ein. Die hier möglichen Konfigurationen sind auch über Komponenten der Struktur VisualObjectType möglich. Sehen Sie dazu die Beschreibung zur Kategorie "Programmierfähigkeit" eines Visualisierungselements; dort finden Sie die gültigen Werte und jeweilige Auswirkung der einzelnen Strukturkomponenten.
Wenn in Kategorie 'Text' entsprechende feste Definitionen zu Textparametern vorliegen, werden diese durch die laufenden Variablenwerte überschrieben.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Die Parameter des Dialogs:
Parameter | Bedeutung: | Beispiel eines Eintrags einer Projektvariable: | Beispiel-Verwendung der Variablen im Programm: | entspricht Komponente von Struktur VisualObjectType: |
|---|---|---|---|---|
Textfarbe: | Textfarbe | "plc_prg.var_textcolor" | var_textcolor=16#FF00FF -> Farbe | dwTextColor |
Textflags: | Textposition (rechts, links, zentriert...) | "plc_prg.textpos" | textpos:=2 -> Text rechtsbündig platziert | dwTextFlags |
Fonthöhe: | Fonthöhe in Pixel | ".fonth" | fonth:=16; -> Fonthöhe 16 pt | ntFontHeight |
Fontname: | Font-Bezeichnung | "vis1.fontn" | fontn:=arial; -> Arial wird verwendet | stFontName |
Fontflags: | Fontdarstellung (Fett, Unterstrichen, Italic...) | "plc_prg.fontchar" | fontchar:=2 -> Text wird fett dargestellt | dwFontFlags |
Linienstärke
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Linienstärke für ein Element auswählen. Als Optionen sind Stärken von 1 bis 5 Pixel vorgegeben, zusätzlich kann manuell ein anderer Wert (Sonstige:), oder eine Projektvariable (Variable für Linienstärke:) eingegeben werden, letzteres auch über die Eingabehilfe (<F2>).
Wenn der Parameter zusätzlich über eine Strukturvariable (s.u. Kategorie 'Programmierfähigkeit') definiert ist, wird im Online Betrieb zunächst die ev. unter 'Variable für Linienstärke' angegebenen Projektvariable ausgewertet !
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Linienstärke)
Farben
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Farben)
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Farben Grundfarben und Alarmfarben für die Innenfläche und den Rahmen Ihres Elements auswählen. Die Optionen Keine Farbe innen und Keine Rahmenfarbe ermöglichen die Erstellung transparenter Elemente.
Wenn Farbparameter auch dynamisch, d.h. über eine Systemvariable bzw. Strukturvariable (s.u. Kategorie 'Farbvariablen' bzw. 'Programmierfähigkeit') geliefert werden, werden die hier vorgenommenen statischen Definitionen überschrieben.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Wenn Sie in der Kategorie Variablen im Feld Farbwechsel nun eine boolsche Variable eingeben, so wird das Element in der eingestellten Farbe dargestellt, solange die Variable FALSE ist. Ist die Variable TRUE, so wird das Element in seiner Alarmfarbe dargestellt.
Die Farbwechsel-Funktion ist erst aktiv, wenn sich die Steuerung im Online Modus befindet! Wenn Sie die Farbe für den Rand ändern wollen, dann drücken Sie die Schaltfläche Rahmen, ansonsten Innen. In jedem Fall öffnet der Dialog zur Auswahl der Farbe.
Hier können Sie aus den Grundfarben und den selbst definierten Farben den gewünschten Farbton auswählen. Durch Drücken der Schaltfläche Farben definieren können Sie die selbst definierten Farben verändern.
Farbvariablen
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Farbvariablen)
Hier können Sie Projektvariablen eintragen (z.B. PLC_PRG.color_inside), deren Wert dann im Online Modus die jeweilige Eigenschaft bestimmen: Die hier möglichen Konfigurationen sind auch über Komponenten der Struktur VisualObjectType möglich. Sehen Sie deshalb die Beschreibung zur Kategorie "Programmierfähigkeit" eines Visualisierungselements; dort finden Sie die gültigen Werte und jeweilige Auswirkung der einzelnen Parameter.
Wenn in Kategorie 'Farbe' entsprechende feste Definitionen zu Farbparametern vorliegen, werden diese im Online Betrieb durch die Werte der hier definierten Variablen überschrieben; ebenso die eventuell zusätzlich über eine Strukturvariable gelieferten Werte.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Die Parameter des Dialogs:
Parameter | Bedeutung: | Beispiel eines Eintrags einer Projektvariable: | Beispiel-Verwendung der Variablen im Programm: | entspicht Komponente von Struktur VisualObjectType: |
|---|---|---|---|---|
Farbe innen: | Füllfarbe | "plc_prg.var_fillcol" | var_fillcol:= 16#FF00FF -> Füllfarbe Pink | dwFillColor |
Alarmfarbe innen: | Füllfarbe im Alarmfall | "plc_prg.var_fillcol_a" | var_fillcol_a:= 16#FF00FF -> Alarmfarbe Pink | dwFillColorAlarm |
Farbe Rahmen: | Rahmenfarbe | "plc_prg.var_framecol" | var_framecol:= 16#FF00FF -> Rahmenfarbe Pink | dwFrameColor |
Alarmfarbe Rahmen: | Rahmenfarbe im Alarmfall | "plc_prg.var_framecol" | var_framecol:= 16#FF00FF -> Alarmfarbe Pink | dwFrameColorAlarm |
FillFlags: | Die vorgenommene Farbkonfiguration für 'Innen' kann aktiviert (FALSE) bzw. deaktiviert (TRUE) werden. | "plc_prg.var_col_off" | var_col_off:=1 -> die Farbzuweisungen für die Füllung des Elements werden nicht ausgeführt, der Rahmen bleibt | dwFillFlags |
FrameFlags: | Darstellung des Rahmens (voll, gestrichelt, ....) | "plc_prg.var_linetype" | var_linetype:=2; -> Rahmen wird gestrichelt dargestellt | dwFrameFlags |
Bewegung absolut
Im Dialog zum Konfigurieren von Visualisierungselementen können in der Kategorie Bewegungabsolut in den Feldern X- bzw. Y-Offset Variablen eingetragen werden, die das Element in X- bzw. Y-Richtung in Abhängigkeit des jeweiligen Variablenwertes verschieben. Eine Variable im Feld Skalierung verändert die Größe des Elements linear zum Variablenwert. Der aktuelle Variablenwert, der als Skalierungsfaktor dient, wird implizit durch 1000 dividiert, damit nicht notwendigerweise Real-Variablen verwendet werden müssen, um eine Verkleinerung des Elements zu erreichen. Die Größenänderung des Elements geht immer vom Element-Drehpunkt aus. Eine Variable im Feld Winkel bewirkt eine Drehung des Elements um seinen Drehpunkt in Abhängigkeit des Variablenwertes (positiver Wert = mathematisch positiv = Uhrzeigersinn). Der Wert wird in Grad ausgewertet. Bei Polygonen rotiert jeder Punkt, daß heißt das Polygon dreht sich. Bei allen anderen Elementen rotiert das Objekt, wobei immer die obere Kante oben bleibt.
Der Drehpunkt erscheint nach einmaligem Anklicken des Elements und wird als kleiner schwarzer Kreis mit einem weißen Kreuz dargestellt ( 
). Mit gedrückter linker Maustaste können Sie den Drehpunkt verschieben.
Wenn der Parameter zusätzlich über eine Strukturvariable (s.u. Kategorie 'Programmierfähigkeit') geliefert wird, wird im Online Betrieb zunächst die hier angegebene Variable ausgewertet.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Bewegung absolut)
Bewegung relativ
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Bewegung relativ)
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Bewegung relativ den einzelnen Elementkanten Variablen zuordnen. In Abhängigkeit der Variablenwerte bewegen sich dann die Kanten. Die einfachste Möglichkeit Variablen in die Felder einzugeben ist die Eingabehilfe (<F2>).
Die vier Einträge geben die vier Seiten ihres Elements an. Die Grundposition der Kanten ist stets auf Null, ein neuer Wert der Variablen in der entsprechenden Spalte, verschiebt die Grenze um diesen Wert in Pixel. Die eingegebenen Variablen sollten also vom Typ INT sein.
| Positive Werte verschieben die horizontalen Kanten nach unten bzw. die vertikalen Kanten nach rechts! |
Wenn der Parameter zusätzlich. über eine Strukturvariable (s.u. Kategorie 'Programmierfähigkeit') geliefert wird, wird im Online Betrieb zunächst die hier angegebene Variable ausgewertet.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Variablen
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Variablen)
Im Dialog zum Konfigurieren von Visualisierungselementen können Sie in der Kategorie Variablen (wie in den Kategorien 'Textvariablen' und 'Farbvariablen') Variablen angeben, die den Zustand des Visualisierungselements beschreiben sollen. Benützen Sie dazu am besten die Eingabehilfe (<F2>).
Wenn die Parameter zusätzlich über eine Strukturvariable (siehe Kategorie 'Programmierfähigkeit') geliefert werden, werden im Online Modus zuerst die hier eingetragenen Projektvariablen ausgewertet.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Die Konfigurationsmöglichkeiten:
Unsichtbar: Wenn die hier eingetragene boolsche Variable den Wert FALSE hat, dann ist das Visualisierungselement sichtbar. Besitzt die Variable den Wert TRUE, dann ist das Element unsichtbar.
Eingabe deaktivieren: Wenn die hier eingetragene boolsche Variable den Wert TRUE hat, dann werden alle Einstellungen der Kategorie 'Eingabe' nicht berücksichtigt.
Farbwechsel: Wenn die hier eingetragene boolsche Variable den Wert FALSE hat, dann wird das Visualisierungselement in seiner Grundfarbe dargestellt. Ist die Variable TRUE, dann wird das Element in seiner Alarmfarbe dargestellt.
Textausgabe:
• Wenn Sie im Feld Inhalt der Kategorie Text zusätzlich zum Text oder ausschließlich "%s" eingegeben haben, wird der Wert der hier bei Textausgabe eingetragenen Variable im Online Modus in der Visualisierung dargestellt. Das "%s" wird dann durch den Wert ersetzt.
• Wenn Sie im Feld Inhalt der Kategorie Text zusätzlich zum Text "%<PREFIX>" eingegeben haben, wobei "PREFIX" eine bestimmte Zeichenfolge ist (siehe ), dann wird die hier bei Textausgabe eingetragene Variable bzw. der hier eingetragene numerische Wert als ID interpretiert, die in Kombination mit dem Präfix als Referenz auf einen Text dient, der in einer XML-Datei beschrieben ist. Dieser Text wird dann im Online Modus anstelle von "%<PREFIX>" angezeigt. Somit ist eine dynamische Veränderung des anzuzeigenden Textes möglich. Sehen Sie hierzu auch die Beschreibung zum Dialog 'Extras' Einstellungen', Kategorie Sprache, sowie allgemein zur Sprachumschaltung in der Visualisierung.
• Wenn Sie wollen, dass der Wert der Variablen im Online Modus per Tastatur editiert werden kann, aktivieren Sie die Option 'Texteingabe der Variable 'Textausgabe'' in der Kategorie Eingabe.
Tooltipausgabe: Hier können Sie eine Variable vom Typ STRING angeben, deren aktueller Wert als Tooltip des Elements in der Visualisierung erscheint.
Eingabe
Dialog zum Konfigurieren von Visualisierungselementen (Kategorie Eingabe)
Variable toggeln: Wenn diese Option aktiviert ist, toggeln Sie im Online Modus mit jedem Mausklick auf das Element den Wert der Variablen, die in dem Eingabefeld dahinter angegeben ist. Zur Eingabe können Sie über <F2> die Eingabehilfe aufrufen. Der Wert der boolschen Variable ändert sich beim ersten Mausklick auf den gewählten Wert TRUE oder FALSE und beim Loslassen zurück auf den jeweils entsprechenden Gegenwert FALSE oder TRUE.
Variable tasten: Wenn diese Option aktiviert ist, können Sie im Online Modus den Wert der boolschen Variablen, die in dem Eingabefeld dahinter angegeben ist, zwischen TRUE und FALSE wechseln lassen. Platzieren Sie den Mauszeiger auf dem Element, drücken Sie die Maustaste und halten Sie sie gedrückt. Wenn die Option FALSE tasten aktiviert ist, wird der Wert beim Drücken auf FALSE gesetzt, ansonsten auf TRUE. Sobald Sie die Taste wieder loslassen, springt der Variablenwert auf den Ausgangswert zurück.
Zoomen nach Vis...: Wenn diese Option aktiviert ist, können Sie im nachfolgenden Feld angeben, zu welcher Visualisierung im Online Modus gewechselt werden soll, sobald mit der Maus auf das Element geklickt wird. Dabei wird dann erst das Fenster der Ziel-Visualisierung geöffnet und danach das der aktuellen geschlossen.
Sie haben folgende Eingabemöglichkeiten:
• den Namen eines Visualisierungsobjektes aus dem aktuellen Projekt (siehe Object Organizer)
• Soll zu einer Visualisierungsreferenz gesprungen werden, die Platzhalter enthält, können diese direkt beim Aufruf durch Variablennamen bzw. Texte ersetzt werden. Befolgen Sie hierzu die folgende Syntax:
<Visuname>(<Platzhalter1>:=<Text1>, <Platzhalter2>:=<Text2>,..., <Platzhalter n>:=<Textn>) Bei dieser Schreibweise werden die ‚$‘-Zeichen weggelassen. Beim Übersetzen der Visualisierung wird überprüft, ob der eingegebene Text der festgelegten Wertemenge entspricht, wenn nicht wird eine entsprechende Warnung ausgegeben.
Beispiel:
Aufruf der Visualisierung visu1, wobei die in visu1 verwendeten Platzhalter $var_ref1$ und $var_ref2$ durch die Variablen PLC_PRG.var1 bzw. PROG.var1 ersetzt werden: visu1(var_ref1:=PLC_PRG.var1, var_ref2:=PROG.var1)
• eine Programmvariable vom Typ STRING (z.B. PLC_PRG.xxx), über die der Name des Visualisierungsobjekts (z.B. ‚visu1'), zu dem bei Mausklick gewechselt werden soll, vorgegeben werden kann (z.B. xxx := ‚visu1').
• den Befehl ‚ZOOMTOCALLER': In diesem Fall wird im Online Modus per Mausklick auf das Element ein Zurückspringen in die aufrufende Visualisierung erreicht, falls eine solche Konstellation konfiguriert wurde.
| Die Verwendung einer Programmvariable ist für die PLC HMI CE nicht zulässig. |
Die implizite Variable CurrentVisu (Typ STRING, sehen Sie auch Anhang A zu impliziten (System-) variablen beschreibt den Namen des aktuell geöffneten Visualisierungsobjekts. Sie kann beispielsweise in einer Applikation verwendet werden, um zu steuern, welche Visualisierung geöffnet werden soll, bzw. um festzustellen, welche augenblicklich geöffnet ist.
Dies nur möglich, wenn die Namen der Visualisierungsobjekte in Großbuchstaben definiert sind. (siehe "Anlegen eines Visualisierungsobjekts"). Beispiel: CurrentVisu:='TC_VISU';
Programm ausführen: Wenn diese Option aktiviert ist, können Sie im Eingabefeld dahinter ein oder mehrere ausführbare Programme, ASSIGN- oder spezielle "INTERN-Befehle" eingeben, die dann bei Mausklick auf das Element im Online Modus ausgeführt werden. Dazu erhalten Sie über die Schaltfläche "..." einen Dialog in dem Befehle ausgewählt (Hinzufügen) und in der gewünschten Reihenfolge (Davor, Danach) angeordnet werden können. Beispielsweise gibt es einen Befehl zur Sprachumschaltung in einer Visualisierung. Sehen Sie zur Erklärung der möglichen Befehle: 'Spezielle Eingabemöglichkeiten für "Bedienversionen".
Beispiel: notepad C:/help.txt (das Programm notepad wird gestartet und die Datei help.txt geöffnet)
Text Eingabe der Variable 'Textausgabe': Wenn diese Option aktiviert ist, erhalten Sie im Online Modus in diesem Visualisierungselement die Möglichkeit, einen Wert einzugeben, der nach Drücken der <Eingabetaste> in die Variable geschrieben wird, die im Feld Textausgabe der Kategorie Variablen steht. Wählen Sie aus der Auswahlliste, in welcher Weise diese Eingabe dann im Online-Betrieb vorgenommen werden kann:
Text: Ein Editierrahmen wird geöffnet, in den der Wert eingetippt wird.
Numpad bzw. Keypad: Ein Fenster mit der Nachbildung des numerischen bzw. des alphabetischen Tastaturfeldes wird geöffnet, auf dem durch Aktivieren der entsprechenden Tastenelemente ein Wert eingegeben werden kann. Dies ist beispielsweise sinnvoll für Visualisierungen, die über Touch-Screen-Bildschirmen bedient werden sollen.
Numpad zur Eingabe eines Wertes im Online Modus:
Der Wertebereich für die Eingabe von Werten für nicht-STRING Variablen kann durch Angabe von minimal und maximal möglichem Wert in den Feldern Min: und Max: eingeschränkt werden.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Tooltip
Im Dialog Text für Tooltip erhalten Sie ein Eingabefeld für Text, der in einem Textfenster erscheint, sobald der Mauszeiger im Online Modus über das Element geführt wird. Der Text kann mittels der Tastenkombination <Strg>+<Eingabetaste> mit Zeilenumbrüchen versehen werden.
| Beachten Sie generell die Auswertungsreihenfolge im Online Modus bei mehrfacher Definition einer Elementeigenschaft. |
Zugriffsrechte
Die Bedienmöglichkeiten und die Ansicht einer Visualisierung im Online-Modus können für verschiedene Benutzergruppen unterschiedlich gestaltet werden, indem ihnen pro Element unterschiedliche Zugriffsrechte erteilt werden. Es stehen die in der Benutzerverwaltung des Projekts vorgesehenen acht Arbeitsgruppen zur Verfügung (siehe auch 'Projekt' 'Objekt' 'Eigenschaften' bzw. 'Projekt' 'Passwörter für Arbeitsgruppen'). Die Rechtevergabe erfolgt über Aktivieren des entsprechenden Zugriffsrechts im folgenden Dialog in der Kategorie Zugriffsrechte der Konfiguration eines Visualisierungselements:
Dialog zum Konfigurieren der Zugriffsrechte für ein Visualisierungselement (Kategorie Zugriffsrechte)
Die Zugriffsrechte für Visualisierungselemente haben folgende Bedeutung:
Kein Zugriff Element ist nicht sichtbar
Lesezugriff Element ist sichtbar aber nicht bedienbar (keine Eingaben möglich)
Vollzugriff Element ist sichtbar und bedienbar
Die für ein Visualisierungselement gesetzten Zugriffsrechte werden für alle weiteren Elemente aller im Projekt enthaltenen Visualisierungen sofort übernommen, wenn die Option Für alle Visualisierungselemente übernehmen aktiviert wird.
| Beachten Sie, dass die für einen kompletten Visualisierungsbaustein (Visualisierungsobjekt) über 'Projekt''Objekt' 'Eigenschaften' gesetzten Zugriffsrechte von denen der einzelnen Visualisierungselemente unabhängig sind ! |
Programmierfähigkeit einer Visualisierung
Neben der Möglichkeit, feste Einstellungen für das Aussehen eines Elements in den Konfigurationsdialogen vorzunehmen kann auch eine dynamische Steuerung über Variablen erfolgen. Dazu können die Visualisierungselemente mit normalen Projektvariablen verknüpft werden, es kann dem Element aber auch gezielt eine Strukturvariable zugewiesen werden, die ausschließlich zur Programmierung der Eigenschaften verwendet wird:
| Beachten Sie die Auswertungsreihenfolge, die später im Online Modus gilt: |
Zur Konfiguration der Elementeigenschaften über eine Strukturvariable gehen Sie folgendermaßen vor:
Tragen Sie im Konfigurationsdialog der Kategorie Programmierfähigkeit im Feld Objekt Name: einen neuen, im Projekt eindeutigen (!) Variablennamen ein. Dazu müssen Sie die Option durch einen Mausklick in das Kästchen aktivieren. Die Variable erhält automatisch den Typ der Struktur VisualObjectType, die Bestandteil einer Bibliothek ist. Die Deklaration erfolgt implizit und ist im Projekt nicht unmittelbar sichtbar.
Nach dem nächsten Übersetzungslauf kann die dem Visualisierungselement zugewiesene Strukturvariable im Projekt verwendet werden. (Tipp hierzu: Aktivieren Sie die Intellisense-Funktion 'Komponenten auflisten' in den Projektoptionen, Kategorie Editor, um nach Eingabe des Variablennamens, gefolgt von einem Punkt, die Strukturelemente in einer Auswahlliste angeboten zu bekommen). Wenn Sie beispielsweise einen Objekt Namen "visu1_line" für ein Visualisierungselement eingegeben haben, können Sie im Programm z.B. mit visu1_line.nLIneWidth:=4 die Liniendicke für dieses Element festlegen.
Dialog zum Konfigurieren der Programmierfähigkeit eines Visualisierungselementes (Kategorie Programmierfähigkeit)
Die Struktur VisualObjectType:
Die folgende Tabelle zeigt alle in Struktur VisualObjectType verfügbaren Elemente und die entsprechende Konfigurationsmöglichkeit in den Dialogen der verschiedenen Kategorien:
Am Beginn des Komponentennamens ist der Datentyp integriert. Dabei bedeutet:
n INT
dw DWORD
b BOOL
st STRING
Komponente | Bedeutung
| Beispiel (für das Element wurde der Object Name "vis1" definiert. ) | entsprechende Einstellmöglichkeit im Konfigurationsdialog: |
|---|---|---|---|
nXOffset:INT; | Verschieben des Elements in X-Richtung | vis1.nXOffset:=val2; | - Kat. Bewegung absolut: |
nYOffset:INT; | Verschieben des Elements in Y-Richtung | vis1.nYOffset:=22; | - Kat. Bewegung absolut: |
nScale:INT; | Größenänderung | vis1.nScale:=plc_prg.scale_var; | - Kat. Bewegung absolut: |
nAngle:INT; | Rotieren des Elements um seinen Drehpunkt | vis1.anglevar:=15; | - Kat. Bewegung absolut:
|
Komponente | Bedeutung | Beispiel (für das Element wurde der Object Name "vis1" definiert. ) | entsprechende Einstellmöglichkeit im Konfigurationsdialog: |
nLeft:INT; | Verschieben der linken Elementkante in X-Richtg. | vis1.nLeft:=val2; | - Kat. Bewegung absolut: |
nTop:INT; | Verschieben der oberen Elementkante in Y-Richtg. (pos.® n.unten) | vis1.nTop:=val2; | - Kat. Bewegung absolut: |
nRight:INT; | Verschieben der rechten Elementkante in X-Richtg. | vis1.nRight:=val2; | - Kat. Bewegung absolut: |
nBottom:INT; | Verschieben der unteren Elementkante in | vis1.nBottom:=val2; | - Kat. Bewegung absolut: |
bInvisible:BOOL; | bewirkt Wechsel zwischen Sichtbar und Unsichtbar durch Wechsel von TRUE und FALSE | vis1.visible:=TRUE; | - Kat. Farben: Keine Farbe |
stTextDisplay: STRING; | Text, der im Element erscheint | vis1.TextDisplay:='ON / OFF'; Element wird mit diesem Text beschriftet | - Kat. Text: Eintrag bei |
bToggleColor: BOOL; | bewirkt Farbwechsel durch Wechsel von TRUE und FALSE | vis1.bToggleColor:=alarm_var; | - Kat. Eingabe: Variable |
bInputDisabled: BOOL; | Eingaben aus Kategorie Eingabe werden bei TRUE beachtet, bei FALSE nicht | vis1.bInputDisabled:=FALSE; | - Kat. Variablen: Eingabe |
stTooltipDisplay:STRING; | Text des Tooltips | vis1.stTooltipDisplay:= | - Kat. Text für Tooltip:
|
Komponente | Bedeutung | Beispiel (für das Element wurde der Object Name "vis1" definiert. ) | entsprechende Einstellmöglichkeit im Konfigurationsdialog: |
dwTextFlags: | Position des Textes: 1 linksbündig Es sollte immer sowohl die horizontale als auch die vertikale Positionierung gesetzt sein (Addition der Werte)! | vis1.dwTextFlags:=36;
| - Kat. Text: Optionen von |
dwTextColor : DWORD; | Textfarbe (zur Eingabe der Farbwerte siehe im Anschluss an die Tabelle) | vis1.dwTextColor := 16#00FF0000; | - Kat. Text: Schrift | Farbe |
nFontHeight : INT; | Fonthöhe in Pixel. | vis1.nFontHeight:=16; | - Kat. Text: Schrift | Grad' |
dwFontFlags : DWORD; | Fontdarstellung. Folgende Flags können gesetzt werden: 1 italic + Kombinationen durch Addition der Werte | vis1.dwFontFlags:=10; | - Kat. Text: Schrift | |
stFontName : STRING; | Fontname
| vis1.stFontName:=’Arial’; | - Kat. Text: Schrift | |
nLineWidth : INT; | Linienstärke des Elementrahmens | vis1.nLWidth:=3; | - Kat. Linienstärke
|
dwFillColor : DWORD; | Füllfarbe.
| vis1.dwFillColor":= | - Kat. Farben: Farbe | |
Komponente | Bedeutung | Beispiel (für das Element wurde der Object Name "vis1" definiert. ) | entsprechende Einstellmöglichkeit im Konfigurationsdialog: |
dwFillColorAlarm : DWORD; | Füllfarbe im Alarmfall (durch TRUE von Komponente bToggleColor, siehe oben) | vis1.dwFillColorAlarm:= | - Kat. Farben: Alarmfarbe | |
dwFrameColor: DWORD; | Rahmenfarbe (zur Eingabe der Farbwerte siehe im Anschluss an die Tabelle) | vis1.dwFrameColor:= | - Kat. Farben: Farbe | |
dwFrameColorAlarm: DWORD; | Rahmenfarbe im Alarmfall (durch TRUE von Komponente bToggleColor, siehe oben) | vis1.dwFrameColorAlarm:=16#00808080; (wenn Variable vis1.bToggleColor auf TRUE gesetzt wird, wird der Elementrahmen grau) | - Kat. Farben: Alarmfarbe |
dwFillFlags: DWORD; | Farbe, wie mit den Farbvariablen definiert, kann an und abgeschaltet werden. 0 = eingeschaltet, >0 = ausgeschaltet | vis1.dwFillFlags:=1; | - Kat. Farben: Keine Farbe |
dwFrameFlags: DWORD; | Rahmen-Darstellung 0 Volle Linie | vis1.FrameFlags:=1; | - Kat. Farbvariablen: |
Die Eingabe von Farbwerten:
Beispiel: e1.dwFillColor := 16#00FF00FF;
Eine Farbe wird als Hexadezimalzahl angegeben, die sich aus den Blau/Grün/Rot-Anteilen (RGB) ergibt. Die ersten zwei Nullen nach "16#" sollten gesetzt werden, um die DWORD Größe zu füllen. Für jeden Farbwert stehen 256 (0-255) Farben zur Verfügung
FF Blauanteil
00 Grünanteil
FF Rotanteil
Beispiel für ein blinkendes Visualisierungselement:
Für ein Rechteck-Element wird eine globale Variable „blinker" vom Typ „VisualObjectType" angelegt. In einem Programm oder Funktionsbaustein kann dann der Wert eines Elements innerhalb der Struktur verändert werden.
PROGRAM PLC_PRG
VAR
n:INT:=0;
bMod:BOOL:=TRUE;
END_VAR
(* Blinkendes Element *)
n:=n+1;
bMod:= (n MOD 20) > 10;
IF bMod THEN
blinker.nFillColor := 16#00808080; (* Grau *)
ELSE
blinker.nFillColor := 16#00FF0000; (* Blau *)
END_IF