Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ InTouch HMI

Methodenliste für Windows-Steuerelemente

  • Last UpdatedApr 24, 2026
  • 3 minute read

Die Windows-Steuerelemente bieten zur Laufzeit eine Reihe von Methoden zum Zugriff per Skript.

Die folgende Tabelle ist eine Liste an Methoden, die Sie in Skripten verwenden können, um Folgendes zu erreichen:

  • den Inhalt eines Eingabefelds aus einer oder in eine Datei laden und speichern

  • die Einträge eines Listen- und Kombinationsfelds ändern

  • die Einträge eines Listen- und Kombinationsfelds ändern

    Methode

    Zweck, Syntax und zusätzliche Infos

    AddItem

    Zweck: Fügt einen Eintrag (in Zeichenfolge umgewandelt) zur Liste hinzu. Bei einer sortierten Liste wird der neue Eintrag an der passenden Stelle eingefügt und ausgewählt. Anderenfalls wird er am Ende der Liste angefügt.Wenn dieser Parameter auf -1 gesetzt ist, wird die Zeichenfolge am Ende der Liste eingefügt.

    Verwendet von: Kombinationsfeld, Listenfeld

    Diese Funktion ist nicht verfügbar, wenn ein Listenfeld über die Optionen „Enum“ oder „Array“ befüllt wird.

    Syntax: Steuerelementname.AddItem(Beschriftungstext);

    Info: Neue Listeneinträge hinzufügen

    Löschen

    Zweck: Löscht alle Einträge aus der Liste. Ist die Liste an einen Verweis (Array oder Enum-Attribut) gebunden, so wird dieser gelöscht.

    Diese Funktion ist nicht verfügbar, wenn ein Listenfeld über die Optionen „Enum“ oder „Array“ befüllt wird.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.Clear();

    Info: Listeneinträge löschen

    DeleteItem

    Zweck: Entfernt den Eintrag mit dem angegebenen Index aus der Liste. Der erste Listeneintrag hat den Index 0.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.DeleteItem(Index);

    Info: Listeneinträge löschen

    DeleteSelection

    Zweck: Löscht das aktuell ausgewählte Element aus der Liste.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.DeleteSelection();

    Info: Listeneinträge löschen

    FindItem

    Zweck: Akzeptiert eine Zeichenfolge und „Boolean (IgnoreCase)“ als Parameter und gibt den Index des ersten Eintrags zurück, der mit der angegebenen Zeichenfolge übereinstimmt. Wenn IgnoreCase auf „True“ festgelegt ist, wird die Groß-/Kleinschreibung von SearchString ignoriert, wenn diese auf „False“ festgelegt ist, berücksichtigt „FindItem“ die Groß-/Kleinschreibung beim Ausführen der Suche. Der erste Listeneintrag hat den Index 0.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: ControlName.FindItem(SearchString, IgnoreCase);

    Info: Listeneinträge suchen

    GetItem

    Zweck: Gibt den Eintrag mit dem angegebenen Index zurück. Der erste Listeneintrag hat den Index 0.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Beschriftung = Steuerelementname.GetItem(Index);

    Info: Beschriftung des ausgewählten Eintrags abrufen

    InsertItem

    Zweck: Fügt die angegebene Zeichenfolge nach der aktuellen Auswahl in die Liste ein. Funktioniert nicht bei sortierten Listen.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.InsertItem(Text);

    Info: Neue Listeneinträge hinzufügen

    SetItemData

    Zweck: Verknüpft einen Wert mit dem Listeneintrag mit dem angegebenen Index. Der erste Listeneintrag hat den Index 0.

    Dies funktioniert nur, wenn die Eigenschaft „UseValuesAsItems“ den Wert „False“ hat. Es funktioniert nicht, wenn ein Listenfeld über die Optionen „Enum“ oder „Array“ befüllt wird.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.SetItemData(Index,Wert);

    Info: Werte mit Listeneinträgen verknüpfen

    GetItemData

    Zweck: Gibt den Wert für den Listeneintrag mit dem angegebenen Index zurück. Der erste Listeneintrag hat den Index 0.

    Dies funktioniert nur, wenn die Eigenschaft „UseValuesAsItems“ den Wert „False“ hat. Es funktioniert nicht, wenn ein Listenfeld über die Optionen „Enum“ oder „Array“ befüllt wird.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Wert = Steuerelementname.GetItemData(Index);

    Info: Werte mit Listeneinträgen verknüpfen

    LoadList

    Zweck: Lädt eine Zeichenfolgenliste aus einer Datei, deren Name als Parameter an die Funktion übergeben wird. Wenn kein Pfad angegeben ist, wird der persönliche Ordner des Benutzers verwendet, also zum Beispiel C:\Dokumente und Einstellungen\Benutzername.

    Die Methode funktioniert nicht, wenn ein Listenfeld über die Optionen „Enum“ oder „Array“ befüllt wird.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.LoadList(Dateiname);

    Info: Listeneinträge laden und speichern

    LoadText

    Zweck: Lädt Text aus einer Datei in ein Eingabefeld. Wenn kein Pfad angegeben ist, wird der persönliche Ordner des Benutzers verwendet, also zum Beispiel C:\Dokumente und Einstellungen\Benutzername.

    Verwendet von: Eingabefeld

    Syntax: Steuerelementname.LoadText(Dateiname);

    Info: Methoden eines Eingabefelds

    SaveList

    Zweck: Speichert eine Liste in einer Datei, deren Name als Parameter an die Funktion übergeben wird. Wenn kein Pfad angegeben ist, wird der persönliche Ordner des Benutzers verwendet, also zum Beispiel C:\Dokumente und Einstellungen\Benutzername.

    Verwendet von: Kombinationsfeld, Listenfeld

    Syntax: Steuerelementname.SaveList(Dateiname);

    Info: Listeneinträge laden und speichern

    SaveText

    Zweck: Speichert den aktuellen Text im Eingabefeld in einer Datei. Wenn kein Pfad angegeben ist, wird der persönliche Ordner des Benutzers verwendet, also zum Beispiel C:\Dokumente und Einstellungen\Benutzername.

    Verwendet von: Eingabefeld

    Syntax: Steuerelementname.SaveText(Dateiname);

    Info: Methoden eines Eingabefelds