Elementname

Beispiel: Statusleiste

Optional

Tipp: Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Elementtyp

Bild

Statische ID

Bezeichner der Bilddatei für eine statische Zuordnung

ID der Bilddatei ein, wie sie in der entsprechenden Bildersammlung definiert ist. Wenn das Bild nicht in der globalen Bildersammlung in der POUs-Ansicht enthalten ist, muss der Instanzpfad angegeben werden. Dabei wird der Name der Bildersammlung vorangestellt, um den Eintrag eindeutig zu machen. Beispiel: imagepool2.button_image.

Bei Eingabe einer neuen ID öffnet sich eine Dateiauswahl. Die ausgewählte Datei wird in der Bildersammlung GlobalImagePool gespeichert.

Siehe auch: Hilfe zum Objekt Bildersammlung.

Rahmen anzeigen

: Die Bilddatei wird mit einem Rahmen dargestellt.

Abschneiden

Voraussetzung: Skalierungsart ist Unskaliert

: Es wird nur der Teil der Visualisierung dargestellt, der in den Elementrahmen passt.

Transparent

: Die Pixel des Bildes, die die Transparenzfarbe haben, werden transparent dargestellt.

Transparenzfarbe

Nur wirksam, wenn Sie die Option Transparent aktiviert haben.

Die Schaltfläche  öffnet den Farbauswahldialog. Darin wählen Sie die Farbe aus, die transparent dargestellt wird.

Skalierungsart

Definition, wie sich das Bild in den Elementrahmen einpasst.

• Isotropisch: Das Bild wird vollständig im Elementrahmen dargestellt und dazu vergrößert oder verkleinert. Dabei werden die Proportionen beibehalten, das Verhältnis Höhe zu Breite bleibt erhalten.

  Wenn die Ausrichtung der Elemente zuein­ander auch innerhalb eines skalierten Frame-Elements beibehalten werden soll, ist Folgendes zu beachten: Unerwünschte horizontale oder vertikale Verschiebungen können vermieden werden, indem die Eigenschaften Horizontale Ausrichtung und Vertikale Ausrichtung auf Zentriert gesetzt wird. Die Ausrichtung der Elemente bleibt dann erhalten und es entstehen keine horizontale und vertikale Verschiebungen.

  Beispiel: Sie haben eine Lampe zentriert oberhalb eines Schalters angeordnet. Die Lampe soll in dieser horizontal zentrierten Position bleiben, auch wenn sich die Größe des Frames verändert.

• Anisotropisch: Das Bild passt sich der Größe des Elementrahmens an, so dass der gesamte Elementrahmen gefüllt ist. Dabei werden die Proportionen nicht beibehalten.

• Unskaliert: Das Bild behält die Original­größe, auch wenn sich die Größe des Elementrahmens ändert. Zu berücksich­tigen ist dabei auch, ob die Option Abschneiden aktiviert ist.

  Bei jeder Neuzuweisung einer Bild-ID wird die Elementgröße auf die Bildgröße autom­atisch angepasst.

Horizontale Ausrichtung

Horizontale Ausrichtung des Elements innerhalb des Elementrahmens:

• Links

• Zentriert

• Rechts

Voraussetzung: Skalierungsart des Bildes ist Isotropisch oder Unskaliert.

Hinweis: Wenn die Visualisierung referenziert wird, dann wirkt die horizontale Ausrichtung innerhalb der Frameposition.

: Eigenschaft Variable erscheint darunter.

Variable

Enumerationsvariable (ENUM VisuElemBase.VisuEnumVerticalAlignment). Enthält die horizontale Ausrichtung.

Enumeration:

TYPE VisuElemBase.VisuEnumHorizonta­lAlignment

END_TYPEBeispiel: PLC_PRG.eHorizontalAlignment

Deklaration:

PROGRAM PLC_PRG VAR

END_VAR

Vertikale Ausrichtung

Vertikale Ausrichtung des Elements innerhalb des Elementrahmens:

• Oben

• Zentriert

• Unten

Voraussetzung: Skalierungsart des Bildes ist Isotropisch oder Unskaliert.

Hinweis: Wenn die Visualisierung referenziert wird, dann wirkt die horizontale Ausrichtung innerhalb der Frameposition.

: Eigenschaft Variable erscheint darunter.

Variable

Enumerationsvariable (ENUM VisuElemBase.VisuEnumVerticalAlignment). Enthält die vertikale Ausrichtung.

Enumeration:

TYPE VisuElemBase.VisuEnumVerticalAlign­ment

END_TYPEBeispiel: PLC_PRG.eHorizontalAlignment

Deklaration:

PROGRAM PLC_PRG VAR

END_VAR

X

X-Koordinate der linken oberen Ecke des Elements

Angabe in Pixel

Beispiel: 10

Y

Y-Koordinate der linken oberen Ecke des Elements

Angabe in Pixel

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Tipp: Die Werte in X, Y, Breiteund Höhe können auch geändert werden, indem Sie im Editor das entsprechende Symbole an eine andere Stelle ziehen.

Winkel

Statischer Drehwinkel in Grad.

Beispiel: 35

Das Element wird im Editor gedreht dargestellt. Rotationspunkt ist das Zentrum des Elements. Ein positiver Wert bewirkt eine Rechtsdrehung.

Tipp: Sie können den Wert im Editor ändern, indem Sie das Element am Griff fokussieren. Wenn der Cursor daraufhin als Drehpfeil  dargestellt wird, können Sie das Element wie am Griff haltend um sein Zentrum drehen.

(1): Griff

Hinweis: Wenn zusätzlich in der Eigenschaft Absolute Bewegung ‣ Innere Rotation ein dynamischer Drehwinkel konfiguriert ist, werden zur Laufzeit der statische und der dynamische Drehwinkel addiert. Der statische Drehwinkel fungiert als Offset.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Farbe

Farbe für den Rahmen

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert.

Hinweis: Der Normalzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen ‣ Farbumschlag nicht definiert ist oder den Wert FALSE hat.

Alarmfarbe

Farbe für den Rahmen im Alarmzustand

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert.

Hinweis: Der Alarmzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen ‣ Farbumschlag den Wert TRUE hat.

Transparenz

Transparenzwert (255 bis 0), der die Durchsichtigkeit der zugehörigen Farbe festlegt.

Beispiel 255: Die Farbe ist deckend. 0: Die Farbe ist voll transparent.

Linienstärke

Wert in Pixel

Beispiel: 2

Hinweis: Die Werte 0 und 1 führen beide zu einer Linienstärke von einem Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein.

Linienart

Art der Liniendarstellung

• Durchgezogen

• Striche

• Punkte

• Strich Punkt

• Strich Punkt Punkt

• Unsichtbar

Text

Zeichenfolge (ohne einfache Anführungszeichen), mit dem das Element beschriftet ist. Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein.

Beispiel: Accesses: %i

Die Variable, die den Istwert für den Platzhalter enthält, ist in der Eigenschaft Textvariable ‣ Text angegeben.

Tooltip

Zeichenfolge (ohne einfaches Anführungszeichen), die als Tooltip des Elements ausgegeben wird. Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein.

Beispiel: Number of valid accesses

Die Variable, die den Istwert für den Platzhalter enthält, ist in der Eigenschaft Textvariable ‣ Tooltip angegeben.

Horizontale Ausrichtung

Horizontale Ausrichtung des Texts innerhalb des Elements.

Vertikale Ausrichtung

Vertikale Ausrichtung des Texts innerhalb des Elements.

Textformat

Definition, wie zu lange Texte dargestellt werden

• Default: Der zu lange Text wird abge­schnitten.

• Zeilenschaltung: Der Text wird in mehrere Zeilen umgebrochen.

• Auslassungspunkte: Der sichtbare Text endet mit "..." und zeigt somit an, dass er nicht vollständig ist.

Schriftart

Beispiel: Standard

: Dialog Schriftart öffnet sich.

: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Beispiel: Schwarz

: Dialog Farbe öffnet sich.

: Auswahlliste mit Stilfarben

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0). Sie bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Die Farbe ist deckend.

0: Die Farbe ist voll transparent.

Hinweis: Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Bild-ID

Variable (STRING). Enthält die Bild-ID. Der Inhalt des Strings entspricht der Beschreibung der Eigenschaft Statische ID.

Beispiel: PLC_PRG.stImageID := 'ImagePool_A.Bild3';

Bitmap-Version

Variable (ganzzahliger Datentyp). Enthält die Version des Bildes.

Wenn die Variable sich ändert, liest die Visualisierung das in Eigenschaft Bild-Id referenzierte Bild neu ein und zeigt es an.

Die Visualisierung stellt bewegte Bilder dar, wenn die Bilddatei auf der Steuerung ständig aktualisiert und dabei die Versionsvariable erhöht wird. Dazu muss die Applikation so programmiert sein.

Mögliche Anwendungsfälle

• Anzeige von Grafiken, die von der Applika­tion generiert werden

• Anzeige von Bildern, die beispielsweise über eine Kamera aktualisiert werden

Bewegung

X

Variable (numerischer Datentyp). Sie enthält die X-Position in Pixel.

Beispiel PLC_PRG.iPos_X.

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

Variable (numerischer Datentyp). Sie enthält die Y-Position in Pixel.

Beispiel PLC_PRG.iPos_Y.

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp). Enthält den Drehwinkel in Grad.

Beispiel PLC_PRG.iAngle1.

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

Skalierung

Variable (ganzzahliger Datentyp). Bewirkt eine zentrische Streckung.

Beispiel PLC_PRG.iScaling.

Bezugspunkt ist die Eigenschaft Zentrum.

Der Wert 1 verkleinert das Element um den Faktor 0.001. Der Wert 1000 belässt das Element in Originalgröße.

Innere Rotation

Variable (numerischer Datentyp). Enthält den Drehwinkel in Grad.

Beispiel: PLC_PRG.iAngle2.

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol dargestellt.

Hinweis: Wenn in der Eigenschaft Position ‣ Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset).

Bewegung links-oben

X

Variable (Ganzzahliger Datentyp). Sie enthält die Anzahl in Pixel, um die die linke Kante horizontal verschoben wird. Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach rechts.

Beispiel : PLC_PRG.iDeltaX

Y

Variable (Ganzzahliger Datentyp). Sie enthält die Anzahl in Pixel, um die die obere Kante vertikal verschoben wird. Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach unten.

Beispiel : PLC_PRG.iDeltaY

Bewegung rechts-unten

X

Variable (Ganzzahliger Datentyp). Sie enthält die Anzahl der Pixel, um die die rechte Kante horizontal verschoben wird. Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach rechts.

Beispiel : PLC_PRG.iDeltaWidth

Y

Variable (Ganzzahliger Datentyp). Sie enthält die Anzahl der Pixel, um die die untere Kante vertikal verschoben wird. Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach unten.

Beispiel : PLC_PRG.iDeltaHeight

Textvariable

Variable (Datentyp konform mit der Formatierungsangabe). Sie enthält das, was an Stelle der Formatierungsangabe ausgegeben wird.

Beispiel: PLC_PRG.iAccesses

Hinweis: Die Formatierungsangabe ist Teil des Textes in der Eigenschaft Texte ‣ Text .

Hinweis: Wenn Sie hier eine Variable vom Typ einer textlistenunterstützten Enumeration angeben, wird automatisch hinter dem Variablennamen in spitzen Klammern der Name des Enumerationsdatentyps hinzugefügt. Beispiel: PLC_PRG.enVar <enumeration name>. Dann erscheint bei der Textausgabe anstelle des numerischen Werts der Enumerationskomponente der symbolische Wert. Sehen Sie hierzu die Hilfeseite zu Enumerationen.

Tooltipvariable

Variable (Datentyp konform mit der Formatierungsangabe). Sie enthält das, was an Stelle der Formatierungsangabe ausgegeben wird.

Beispiel: PLC_PRG.iAccessesInTooltip

Hinweis: Die Formatierungsangabe ist Teil des Textes in der Eigenschaft Texte ‣ Tooltip .

Textliste

Variable (String) oder Name der Textliste als fester String in einfachen Anführungszeichen.

Beispiel: 'Errorlist'

: Auswahlliste mit den im Projekt verfügbaren Textlisten.

Textindex

Textlisten-ID. Sie verweist auf den gewünschten Ausgabetext.

• Als fester String mit der ID in einfachen Anführungszeichen.

  Beispiel: '1'

• Als Variable (STRING) um die Textausgabe dynamisch zu steuern.

  Beispiel: strTextID

  Beispiel Zuweisung: PLC_PRG.strTextID := '1';

Tooltipindex

Textlisten-ID. Sie verweist auf den gewünschten Ausgabetext.

• Als fester String mit der ID in einfachen Anführungszeichen.

  Beispiel: '2'

• Als Variable (STRING) um die Textausgabe dynamisch zu steuern.

  Beispiel: strToolTipID

  Beispiel Zuweisung: PLC_PRG.strToolTipID := '2';

Schriftname

Variable (STRING). Enthält die Schriftart des Textes.

Beispiel: PLC_PRG.stFontVar := 'Arial';

Die Auswahl an Schriftarten entspricht der im Standarddialog Schriftart.

Größe

Variable (Numerischer Datentyp). Enthält die Schriftgröße in Pixel oder Punkten. Die verwendete Einheit ist hinter dem Variablennamen in spitzen Klammern angegeben.

• <pt> : Punkte (Voreinstellung)

  Beispiel: PLC_PRG.iFontHeight <pt>

  Code: iFontHeight : INT := 12;

• <px> : Pixel

  Beispiel: PLC_PRG.iFontHeight <px>

  Code: iFontHeight : INT := 19;

Wenn Sie in das Wertefeld klicken, erscheint dort rechts eine Auswahlliste, mit der Sie die Einheit umstellen können.

Tipp: Die Größe einer Schriftart ist in Punkten angegeben (Beispiel: Arial 12). Verwenden Sie die Einheit Punkte, wenn die variable Schriftgröße zu einer Schriftart passen soll, beispielsweise wenn in der Eigenschaft Texteigenschaft ‣ Schriftart eine Schriftart eingestellt ist.

Flags

Variable (DWORD). Enthält Flags für die Schriftartdarstellung.

Flags:

• 1: Kursiv

• 2: Fett

• 4: Unterstrichen

• 8: Durchgestrichen

Hinweis: Sie können die Schriftartdarstellungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein fetter und unterstrichener Text: PLC_PRG.dwFontType := 6;

Zeichensatz

Variable (DWORD). Enthält eine Zeichensatznummer für die Schriftart.

Die Auswahl an Zeichensatznummern entspricht der Einstellung Skript des Standarddialogs Schriftart.

Farbe

Variable (DWORD). Enthält die Farbe des Texts.

Beispiel: PLC_PRG.dwColorFont:= 16#FF000000;

Flags für Textausrichtung

Variable (Ganzzahliger Datentyp). Enthält die Codierung zur Textausrichtung.

Beispiel: PLC_PRG.dwTextAlignment.

Codierung:

• 0: Oben links

• 1: Horizontal zentriert

• 2: Rechts

• 4: Vertikal zentriert

• 8: Unten

Hinweis: Sie können die Textausrichtungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein vertikal und horizontal zentrierter Tex: PLC_PRG.dwFontType := 5;

Farbumschlag

Die Eigenschaft steuert zur Laufzeit den Farbumschlag.

Wertebelegung:

• FALSE: Element wird mit der in Eigenschaft Farbe angegebenen Farbdefinition darg­estellt.

• TRUE: Element wird mit der in Eigenschaft Alarmfarbe angegebenen Farbdefinition dargestellt.

Belegung der Eigenschaft:

• Platzhalter für die Benutzereingabevariable

  • <Umschalten-/Tastenvariable>

  • <NOT Umschalten-/Tastenvariable>

  Dabei wird der Farbumschlag nicht mit einer eigenen Variablen gesteuert, sondern mit einer Benutzereingabevariable.

  Hinweis: Geben Sie in der Eingabekonfigu­ration des Elements für die Mausklickere­ignisse Umschalten oder Tasten eine Variable an, erst dann ist der Platzhalter gesetzt. Wenn sowohl in Umschalten als auch in Tasten eine Variable angegeben ist, wird die in Tasten angegebene Variable verwendet.

  Tipp: Klicken Sie auf das Symbol , um den Platzhalter <Umschalten-/Tastenvari­able> einzufügen. Wenn allerdings die Eigenschaft Eingabekonfiguration, FALSE Tasten aktiviert ist, erscheint der Platzhalter <NOT Umschalten-/Tasten­variable>.

• Instanzpfad einer Projektvariablen (BOOL)

  Beispiel: PLC_PRG.xColorIsToggeled

  Hinweis: Deklarieren und implementieren Sie im Code die hier angegebene Variable. Deren Wertebelegung bestimmt, wann die Farbe umschlägt.

Farbe

Farbvariable für den Rahmen

• Variable (DWORD) für die Farbe

  Beispiel: PLC_PRG.dwColor

• Farbliteral

  Beispiel Grau, deckend: 16#FF888888

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert.

Hinweis: Der Normalzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen ‣ Farbumschlag nicht definiert ist oder den Wert FALSE hat.

Alarmfarbe

Farbvariable für den Rahmen im Alarmzustand

• Variable (DWORD) für die Alarmfarbe

  Beispiel: PLC_PRG.dwAlarmColor

• Farbliteral

  Beispiel Rot, deckend: 16#FFFF0000

Hinweis: Der Alarmzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen ‣ Farbumschlag den Wert TRUE hat.

Linienstärke

Variable (ganzzahliger Datentyp). Enthält die Linienstärke in Pixel.

Hinweis: Die Werte 0 und 1 führen beide zu einer Linienstärke von einem Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein.

Linienart

Variable (DWORD). Steuert die Linienart.

Codierung:

• 0: Durchgezogene Linie

• 1: Gestrichelte Linie

• 2: Gepunktete Linie

• 3: Liniendarstellung "Strich Punkt"

• 4: Liniendarstellung "Strich Punkt Punkt"

• 8: Unsichtbar: Die Linie wird nicht geze­ichnet

Unsichtbarkeit

Variable (BOOL). Schaltet die Sichtbarkeit des Elements um.

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Eingaben deaktivieren

Variable (BOOL). Schaltet die Bedienbarkeit des Elements um.

TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt.

Animationsdauer

Zeit in Millisekunden, in der das Element eine Animation ausführt

Beispiel: 500

In den Vordergrund bringen

Eigenschaftenwert (BOOL)

TRUE: Das Element wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Element wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Die Schaltfläche Konfigurieren öffnet den Dialog Eingabekonfiguration um eine Benutzereingabekonfiguration zu erstellen oder zu bearbeiten.

Eine Konfiguration enthält für das zugehörige Eingabeereignis eine oder mehrere Eingabeaktionen. Bereits erstellte Eingabeaktionen erscheinen darunter.

Beispiel: ST-Code ausführen: PLC_PRG.i_x := 0;

OnDialogClosed

Eingabeereignis: Ein Benutzer schließt einen Dialog.

OnMouseClick

Eingabeereignis: Ein Benutzer fokussiert das Element und führt darauf einen vollständigen Mausklick aus. Er drückt die Maustaste und gibt sie wieder frei.

OnMouseDown

Eingabeereignis: Ein Benutzer fokussiert das Element und drückt die Maustaste.

OnMouseEnter

Eingabeereignis: Ein Benutzer zieht den Mauszeiger auf das Element.

OnMouseLeave

Eingabeereignis: Ein Benutzer zieht den Mauszeiger von einem Element weg.

OnMouseMove

Eingabeereignis: Ein Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs.

OnMouseUp

Eingabeereignis: Der Benutzer lässt die Maustaste innerhalb des Elementbereichs los.

Tastaturkürzel

Tastaturkürzel auf dem Element, um bestimmte Eingabeaktionen auszulösen.

Bei Eintreten des Tastaturkürzel-Ereignisses werden die unter der Eigenschaft Ereignis(se) angegebenen Eingabeaktionen ausgelöst.

Taste

Taste, bei dessen Drücken eine Eingabeaktion folgt.

Beispiel: T

Ereignis(se)

• Keine Aktion

• MouseDown-Aktion: Ein Drücken der Taste löst die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown konfigu­riert sind.

• MouseUp-Aktion: Ein Freilassen der Taste löst die Eingabeaktionen aus, die in der Eigenschaft OnMouseUp konfiguriert sind.

• MouseDown/MouseUp-Aktion: Ein Drücken und Loslassen der Taste löst die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown und OnMouseUp konfigu­riert sind.

Umschalten

: Kombination mit Umschalttaste

Beispiel: Umschalt + T

Steuerung

: Kombination mit Steuerungstaste

Beispiel: Strg + T

Alt

: Kombination mit Alt-Taste

Beispiel Alt + T

Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.

Statusmeldungen:

• Nicht gesetzt. Alle Rechte: Zugriffsrecht für alle Benutzergruppen: bedienbar

• Rechte sind vergeben: eingeschränkte Rechte: Mindestens für eine Gruppe ist der Zugriff eingeschränkt