Skip to main content

Visualisierungselement: Combobox, Array

Symbol:

_visu_img_combobox_array.png

Kategorie: Allgemeine Steuerelemente

Das Element zeigt Werte eines Arrays als Auswahlliste an. Wenn der Visualisierungsbenutzer auf einen Eintrag klickt, wird der Arrayindex des Eintrags in eine Integer-Variable geschrieben.

Hinweis

0_Sample_ProjectBeispielprojekt über Comboboxen in Kombination mit Arrays und Textlisten

Elementeigenschaften

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Advanced oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften zur Verfügung.

Elementname

Beispiel: Liste_Produktnummer

Tipp

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

Elementtyp

Combobox, Array

Position

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Tipp

Sie können die Werte ändern, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Spalten

Das Element Combobox Array visualisiert eine Array- oder Strukturvariable in Tabellenansicht. Der Index von Arrayelementen oder von Komponenten einer Struktur wird in einer Spalte oder einer Zeile angezeigt. Zweidimensionale Arrays oder Arrays einer Struktur werden in mehreren Spalten angezeigt. Sie legen die visualisierte Variable in der Eigenschaft Datenarray fest. Wenn Sie dort eine Variable zugewiesen haben, können Sie die Darstellung der Tabellenspalten, in der die jeweiligen Arrayelemente dargestellt werden, festlegen. Sie können jede Spalte, die einem Index n zugeordnet ist, individuell konfigurieren.

Spalten

  • [<n>]

Aufgrund der Struktur der Variablen, die unter Datenarray definiert ist, wird automatisch die Anzahl der Spalten ermittelt und die Spalten über den Index n beschrieben.

Beispiel:

Es werden drei Spalten [0], [1] und [2] gebildet:

StringTabelle : ARRAY [0..2, 0..4] OF STRING := ['BMW','Audi','Mercedes','VW','Fiat', '150','150','150','150','100','blau','grau','silber','blau','rot'];

Max. Arrayindex

Optional

Variable (ganzzahliger Datentyp) oder Wert

Legt fest, bis zu welchem Arrayindex die Daten angezeigt werden

Zeilenhöhe

Höhe der Zeilen in Pixel

Anzahl sichtbarer Zeilen

Optional

Ist das Array größer als die Anzahl der sichtbaren Zeilen, so wird ein Scrollbalken eingeblendet

Größe des Scrollbalkens

Breite des vertikalen Scrollbalkens in Pixel

Tabelle 10. Elementeigenschaft Spalten: Spalte [<n>]

Breite

Spaltenbreite in Pixel

Bildspalte

_cds_icon_option_activated.png: In der Spalte können Bilder angezeigt werden. Es werden Bilder der globalen Bildersammlung oder von benutzerdefinierten Bildersammlungen verwendet. Dabei stehen in den Zellen der Tabelle die Bild-IDs, wie in der Bildersammlung definiert.

Bildkonfiguration

Füllmodus

  • Zelle ausfüllen

    Das Bild passt sich an die Größe der Zelle ohne Berücksichtigung des Höhen-Breiten-Verhältnisses an.

  • Zentriert

    Das Bild wird in der Zelle zentriert und behält seine Proportionen; d.h. das Verhältnis Höhe-Breite bleibt erhalten.

Transparenz

_cds_icon_option_activated.png: Farbe, die in Transparenzfarbe angegeben ist, wird transparent dargestellt

Transparenzfarbe

Wenn die Eigenschaft Transparenz aktiviert ist, wird die hier angegebene Farbe nicht dargestellt. Pixel mit dieser Farbe sind dann durchsichtig.

Textausrichtung in Spalte

  • Links

  • Zentriert

  • Rechts

Vorlage verwenden

_cds_icon_option_deactivated.png: Die Arraydaten werden in der Tabelle angezeigt.

_cds_icon_option_activated.png: Die Tabellenzellen erhalten (konfigurierbar pro Spalte) zusätzliche Eigenschaften, nämlich alle die ein Rechteck hat. Damit erhält eine Tabellenzelle den gleichen Funktionsumfang wie ein Rechteck. Die zusätzlichen Eigenschaften werden unter der Eigenschaft Vorlage angezeigt.

Anwendungsfall: Um eine Benutzereingabe (beispielsweise den Klick in eine Zelle) verarbeiten zu können, muss diese Zelle über eine Eingabekonfiguration verfügen. Dies ist möglich, wenn die Option Vorlage verwenden aktiviert ist. Dann steht unter anderem die Eigenschaft Eingabekonfiguration zur Verfügung und dort kann für ein Mausereignis eine Folgeaktion konfiguriert werden.

Beispiel: Wenn ein Nutzer in der laufenden Visualisierung auf die so konfigurierte Zelle klickt, toggelt die boolesche Variable, die der Zelle zugeordnet ist.

Textausrichtung der Überschrift aus der Vorlage

_cds_icon_option_activated.png: Die Spaltenbeschriftung wird mit den Texteigenschaften aus der Vorlage erstellt.

Vorlage

Wenn die Eigenschaft Vorlage verwenden aktiviert ist, ist diese Eigenschaft sichtbar und darunter sind alle Eigenschaften eines Rechtecks verfügbar.

Tipp

Diese Eigenschaften und deren Möglichkeiten sind in der Hilfe zum Element Rechteck, abgerundetes Rechteck, Ellipse beschrieben.



Variable

Variable

Speichert zur Laufzeit den Arrayindex des Listeneintrags, auf den der Benutzer klickt

  • Variable (ganzzahliger Datentyp)

    Beispiel: PLC_PRG.iIndexComboboxEntry

Datenarray

Wird als Combobox visualisiert. Jede Arraykomponente wird zu einem Combobox-Eintrag.

  • Arrayvariable (ARRAY[...] OF)

    Beispiel: PLC_PRG.astrCombobox

    Deklaration: astrCombobox : ARRAY[0..4] OF STRING := ['First', 'Second', 'Third', 'Fourth'];

Texte

Tooltip

Zeichenfolge (ohne einfache Anführungszeichen)

Beispiel: Products of customer A

Der Text wird als Tooltip ausgegeben. Wenn im Text ein Platzhalter %<format string> angegeben ist, wird an der Stelle des Platzhalters der Wert der Variable in Eigenschaft Textvariable → Tooltip ausgegeben.

Tipp

Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein.

Tipp

Die eingegebenen Texte werden automatisch in die Textliste GlobalTextList übernommen. Somit können diese Texte lokalisiert werden.

Texteigenschaften

Die Eigenschaften erhalten feste Werte für die Texteigenschaften und wirken auf die Texte, die in Texte → Text oderTexte → Tooltip konfiguriert sind.

Verwenden von

  • Standard Stilwerten: Die Werte des Visualisierungsstils werden übernommen.

  • Benutzerdefinierte Einstellung: Die Eigenschaftengruppe Benutzerdefinierte Texteigenschaften wird eingeblendet. Dort können die Werte individuell angepasst werden.

Benutzerdefinierte Texteigenschaften

Voraussetzung: Sie haben die Texteigenschaft Benutzerdefinierte Einstellung definiert.

Schriftart

Beispiel: Standard

_cds_icon_three_dots.png: Dialog Schriftart öffnet sich.

_cds_icon_arrow_down.png: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Schriftfarbe im Normalzustand

Beispiel: Schwarz

_cds_icon_three_dots.png: Dialog Farbe öffnet sich.

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben

Schriftfarbe bei Alarm

Schriftfarbe, die im Alarmzustand aktiv ist

Wichtig

Sie muss sich von der Schriftfarbe im Normalzustand unterscheiden

Beispiel: Rot

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.

Anmerkung

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

Zustandsvariablen

Die Variablen steuern dynamisch das Verhalten des Elements.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Beispiel: bIsVisible mit VAR bIsVisible : BOOL := FALSE; END_VAR

Eingaben deaktivieren

Variable (BOOL) für das Umschalten der Bedienbarkeit des Elements

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

Tipp

Die Eigenschaft Unsichtbarkeit wird von der Funktionalität „Client-Animation“ unterstützt.

Zentrum

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol _visu_icon_center_point.png dargestellt und dient als Zentrum für die Rotation und die Skalierung.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor das Symbol _visu_icon_center_point.png an eine andere Stelle ziehen.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Absolute Bewegung

Den Eigenschaften können IEC-Variablen zugewiesen werden, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.

Bewegung

X

  • Variable (numerischer Datentyp) für 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) für die Y-Position (in Pixel)

    Beispiel: PLC_PRG.iPos_Y

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

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

Rotation

Variable (numerischer Datentyp) für 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 _visu_icon_center_point.png 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.

_visu_img_prp_rotation.png

Innere Rotation

Variable (numerischer Datentyp) für 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 _visu_icon_center_point.png dargestellt.

Anmerkung

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

_visu_img_prp_inner_rotation.png

Tipp

Sie können die Variablen mit einer Einheitenumrechnung kombinieren.

Tipp

Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität „Client-Animation“ unterstützt.

Animation

Tipp

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungmanager die Option Client-Animationen und Überlagerung systemeigener Elemente unterstützen aktiviert haben.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

  • Variable (Ganzzahliger Wert)

    Beispiel: Menu.tContent mit VAR tContent : INT := 500; END_VAR

  • Ganzzahliges Literal

    Beispiel: 500

. Animierbare Eigenschaften:

  • Absolute Bewegung, Bewegung, X, Y

  • Absolute Bewegung, Rotation

  • Absolute Bewegung, Innere Rotation

  • Absolute Bewegung, Äußere Rotation

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

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

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Eingabekonfiguration

Tipp

Die Schaltfläche Konfigurieren öffnet den Dialog Eingabekonfiguration. Dort können Sie dem Ereignis Folgeaktionen zuweisen.

OnValueChanged

Ereignis, das durch eine Wertänderung Folgeaktionen auslöst

Welche Folgeaktionen ausgelöst werden, wird im Dialog Eingabekonfiguration konfiguriert.

Die festgelegten Folgeaktionen und die jeweils dazugehörige Konfiguration werden unterhalb der Elementeigenschaft angezeigt.

Das Ereignis OnValueChanged kann durch das Compiler-Define VISU_NO_VALUECHANGED im Eigenschaftendialog der Applikation deaktiviert werden.

Zugriffsrechte

Anmerkung

Nur verfügbar, wenn eine Benutzerverwaltung für die Visualisierung eingerichtet ist.

Schaltfläche 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

In diesem Abschnitt: