Elementname

Optional

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

Beispiel: Spannung_ein

Elementtyp

Schaltfläche

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

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Farbe

Farbe, mit der das Element im Normalzustand gefüllt ist.

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

Alarmfarbe

Farbe, mit der das Element während des Alarmzustands gefüllt ist.

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.

Farbverlauf verwenden

: Das Element wird mit einem Farbverlauf gezeichnet.

Farbverlaufsauswahl

Der Dialog Farbverlaufseditor öffnet sich.

Statische ID

Referenz auf ein Bild in einer Bildersammlung im Format <Name der Bildersammlung>.<Bild-ID> zum Beispiel Imagepool.GreenButton.

Wenn das Bild aus GlobalImagePool ist, können Sie den Namen der Bildersammlung weglassen, da CODESYS diese Sammlung immer zuerst durchsucht.

: Dialog Eingabehilfe öffnet sich und listet alle projektweit verfügbaren Bildersammlungen mit deren Bildern auf.

Skalentyp

Verhalten des Bildes bei Änderung der Schaltflächengröße

• Isotropisch: Das Bild behält seine Propor­tionen. Das Verhältnis Höhe-Breite bleibt erhalten, auch wenn Sie die Höhe oder die Breite der Schaltfläche separat verändern.

• Anisotropisch: Das Bild passt sich an die Größe der Schaltfläche an.

• Unskaliert: Das Bild behält die Original­größe, auch wenn Sie die Größe der Schalt­fläche ändern.

Transparenz

Die Visualisierung stellt im Bild die Farbe, die in Transparenzfarbe ausgewählt ist, transparent dar.

Transparenzfarbe

Farbe, die im Bild transparent ist, zum Beispiel Weiß. Wenn der Hintergrund des Bildes, das die Statische ID referenziert, weiß ist, wird dieser Hintergrund transparent dargestellt. Mit Klick auf  öffnet sich ein Farbauswahldialog.

Voraussetzung: Option Transparenz ist aktiviert.

Horizontale Ausrichtung

Horizontalen Ausrichtung des Bitmaps

• Links

• Zentriert

• Rechts

Vertikale Ausrichtung

Vertikalen Ausrichtung des Bitmaps

• Oben

• Zentriert

• Unten

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.

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.

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.

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.

Digitale Variable

Die Eigenschaft steuert zur Laufzeit, ob die Schaltfläche hervorstehend oder gedrückt dargestellt wird.

Wertebelegung:

• FALSE: Schaltfläche wird hervorstehend dargestellt

• TRUE: Schalfläche wird gedrückt dargestellt

An die Eigenschaft übergebenes Argument:

• Platzhalter für die Benutzereingabevariable, um die Darstellung der Schaltfläche mit der Eingabevariablen zu koppeln

  • <Umschalten-/Tastenvariable>

  • <NOT Umschalten-/Tastenvariable>

  Hinweis: Geben Sie in der Eingabekonfigu­ration der Schaltfläche 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 aber die Eigen­schaft Eingabekonfiguration, FALSE Tasten aktiviert ist, erscheint der Platzhalter <NOT Umschalten-/Tastenvariable>.

• Instanzpfad einer Projektvariablen (BOOL)

  Beispiel: prgA.xButtonState

  Hinweis: Implementieren Sie im Code für die hier angegebene Variable eine Wertebele­gung.

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';

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 Benutzereingabe zu erstellen oder zu bearbeiten.

Unter den Ereignissen werden bereits konfigurierte Benutzereingaben kurz aufgelistet. Sie enthalten jeweils die Aktion, die ausgelöst wird, und in knapper Form deren Einstellung.

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

OnDialogClosed

Eingabeereignis: Ein Benutzer schließt einen Dialog.

OnMouseClick

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

OnMouseDown

Eingabeereignis: Der Benutzer drückt die Maustaste.

OnMouseEnter

Eingabeereignis: Der Benutzer zieht den Mauszeiger auf das Element.

OnMouseLeave

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

OnMouseMove

Eingabeereignis: Der Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs.

OnMouseUp

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

Tasten

Bei Auftreten eines Mausklickereignisses wird in der Applikation die unter Variable festgelegte Variable beschrieben. Die Codierung hängt von den Optionen FALSE Tasten und Beim Betreten tasten, falls Maus gefangen ab.

Variable

Variable (BOOL), die beim Mausklicken gesetzt wird.

Beispiel: PLC_PRG.bIsTapped

TRUE: Es liegt ein Mausklickereignis an. Es dauert, solange ein Benutzer die Maustaste drückt während er mit dem Mauszeiger das Element fokussiert. Es endet, wenn er die Taste freigibt.

FALSE: Es liegt kein Mausklickereignis an.

Voraussetzung: Die Option FALSE Tasten ist nicht aktiviert.

FALSE Tasten

: Das Mausklickereignis führt zum komplementären Wert in Variable.

TRUE: Es liegt kein Mausklickereignis an.

FALSE: Solange das Mausklickereignis dauert.

Beim Betreten tasten, falls Maus gefangen

: Bei der Benutzereingabe wird zusätzlich berücksichtigt, ob bei gedrückter Maustaste der Mauszeiger innerhalb oder außerhalb des Elementbereichs gezogen wird.

TRUE: Solange das Mausklickereignis dauert und dabei der Mauszeiger innerhalb des Elementbereichs bewegt wird.

FALSE: Es liegt kein Mausklickereignis an. Oder aber der Benutzer bewegt den Mauszeiger bei gedrückter Maustaste außerhalb des Elementbereichs.

Sobald der Benutzer den Mauszeiger in den Elementbereich zurückbewegt, ist der Wert wieder TRUE. Man sagt, die "Maus ist gefangen".

Umschalten

Bei Auftreten eines Mausklickereignisses wird die Variable gesetzt und bei Beenden des Mausklickereignisses zurückgesetzt.

Variable

Variable (BOOL). Ihr Wert schaltet beim Beenden des Mausklickereignisses um. Das ist, wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger im Elementbereich ist.

Wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger außerhalb des Elementbereich ist, liegt kein Beenden des Mausklickereignisses vor und der Wert wird nicht umgeschaltet.

Tipp: Der Benutzer kann damit eine begonnene Umschalteingabe abbrechen, indem er den Mauszeiger aus den Elementbereich zieht.

Umschalten beim Loslassen, falls Maus gefangen

: Der Wert schaltet um, unabhängig davon, wo der Mauszeiger beim Freigeben der Maustaste ist. Man sagt, die "Maus ist gefangen".

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. Dabei ist nicht die Eingabeaktion selbst angegeben, sondern das Mauseingabeereignis, das auch zu dieser Eingabeaktion führt.

Taste

Taste, bei deren Drücken eine Eingabeaktion folgt.

Beispiel: T

Hinweis: Die folgenden Eigenschaften erscheinen, wenn eine Taste ausgewählt wird.

Ereignis(se)

• Keine Aktion

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

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

• MouseDown/MouseUp-Aktion: Ein Drücken und Loslassen der Taste lösen 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