SrcData
Daten für das Optionsmenü.
Die Dropdown-Liste einer Combobox kann auf zwei verschiedene Arten konfiguriert werden:
Engineering
- Fügen Sie eine Combobox zur Oberfläche hinzu.
- Ändern Sie die Dropdown-Liste beim Attribut ‚Src Data‘ der Kategorie ‚Data‘ mithilfe des Dialogs ‚Combobox Src Data‘
- 1. Definieren Sie die gewünschte Anzahl an Einträgen und ihre Reihenfolge.
- 2. Vergeben Sie für jeden der drei Einträge eine Id, einen Text, der in der Drop-down-Liste angezeigt wird, und den Value, der hinter diesem Eintrag steht.
Zusätzliche Informationen
Per Engineering kann eine einfache Optionsliste zusammengestellt werden. Jede Option besteht aus diesen Bestandteilen:
- ID: Selbst definierte ID
- Text: Anzeigetext
- Value: Wert der später innerhalb der Anwendung weitergeleitet werden kann.
- Category (Version 1.12.744): Eine optionale Kategorie des Wertes, welche im Drop-down des Controls dargestellt wird.
Wird für diesen Parameter ein Binding benutzt, so werden weitere, komplexe Daten unterstützt.
- Arrays können direkt genutzt werden. So kann auch ein String-Array oder Number-Array verbunden werden.
- Objekte werden als key-value Auflistung unterstützt. Der Name der Property wird als Anzeigetext, der Wert als Value interpretiert.
![]() | Mit den Kategorien (und dem vom Wert unabhängigen Anzeigetext) kann eine einfache Gruppierung der Werte erreicht werden. |
Category A
Option 1 => valueA1
Option 2 => valueA2
Category B
Option 1 => valueB1
Option 2 => valueB2Elements | Liste aller hinzugefügter Objekte |
|---|---|
| Löschen des ausgewählten Objekts |
| Ändern der Objektreihenfolge (oben = links) |
| Hinzufügen eines neues Objekts |
Kategorie : General
|
Name |
Beschreibung |
|---|---|
ID | Definition einer freiwählbaren ID für den Listeneintrag – Diese ID muss innerhalb der definierten Einträge eindeutig sein. |
Text | Definition des Texts des Listeneintrags |
Value | Definition des Wertes eines Listeneintrags |
SPS
Array von einer Struktur, welche die Struktur eines Listeneintrags repräsentiert
![]() | Es ist notwendig, dass die Strukturelemente identisch zu den Attributen, die auf TwinCAT HMI-Seite definiert sind, benannt werden. Groß- und Kleinschreibung wird berücksichtigt. |
aComboboxEntries : ARRAY [1..5] OF ST_ComboboxEntry;
TYPE ST_ComboboxEntry:
STRUCT
id : INT;
text : STRING;
value : INT;
END_STRUCT
END_TYPEArray von einem einfach Datentyp
aTexts : ARRAY [1..5] OF STRING;
aValues : ARRAY [1..5] OF INT;- Fügen Sie eine Combobox zur Oberfläche hinzu.
- Verknüpfen Sie das Array mit dem Attribut ‚Src Data‘ der Kategorie ‚Data‘
Schema (Version 1.8): tchmi:framework#/definitions/ListItemList
Schema (Version 1.12): tchmi:framework#/definitions/TcHmi.Controls.Beckhoff.TcHmiCombobox.ListItemList
Attribut-Getter
public getSrcData(): TcHmi.Controls.Beckhoff.TcHmiCombobox.ListItem[] | any[] | Dictionary<any>;Parameter
Name | Typ | Beschreibung |
|---|---|---|
- | - | - |
Rückgabewert
Typ | Beschreibung |
|---|---|
TcHmi.Controls.Beckhoff.TcHmiCombobox.ListItem[] | any[] | Dictionary<any>, null | Der aktuelle Wert des Attributs. |
Attribut-Setter
public setSrcData(valueNew: TcHmi.Controls.Beckhoff.TcHmiCombobox.ListItem[] | any[] | Dictionary<any> | null): void;Parameter
Name | Typ | Beschreibung |
|---|---|---|
valueNew | TcHmi.Controls.Beckhoff.TcHmiCombobox.ListItem[] | any[] | Dictionary<any>, null | Der neue Wert des Attributs. Wird null übergeben, so wirkt der interne Standardwert. |
Rückgabewert
Typ | Beschreibung |
|---|---|
void | Kein Rückgabewert. |
![]() | Verfügbar ab Version 1.8 |



