SrcData

Daten für das Optionsmenü.

Die Dropdown-Liste einer Combobox kann auf zwei verschiedene Arten konfiguriert werden:

Engineering

  1. Fügen Sie eine Combobox zur Oberfläche hinzu.
  2. Ändern Sie die Dropdown-Liste beim Attribut ‚Src Data‘ der Kategorie ‚Data‘ mithilfe des Dialogs ‚Combobox Src Data‘
  3. 1. Definieren Sie die gewünschte Anzahl an Einträgen und ihre Reihenfolge.
  4. 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:

Wird für diesen Parameter ein Binding benutzt, so werden weitere, komplexe Daten unterstützt.

SrcData 1:

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 => valueB2

Elements

Liste aller hinzugefügter Objekte

SrcData 2:

Löschen des ausgewählten Objekts

SrcData 3:

Ändern der Objektreihenfolge (oben = links)

SrcData 4:

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

SrcData 5:

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_TYPE

Array von einem einfach Datentyp

aTexts : ARRAY [1..5] OF STRING;
aValues : ARRAY [1..5] OF INT;
  1. Fügen Sie eine Combobox zur Oberfläche hinzu.
  2. 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.

SrcData 6:

Verfügbar ab Version 1.8