IOSetItem (Funktion)

Mit der Skriptfunktion IOSetItem() können Sie den E/A-Verweis einer E/A-Variablen dynamisch ändern. Die Funktion ändert dabei den Wert des Punktfelds .Reference. Auf diese Weise können Sie den Zugriffsnamen und/oder das Item der Variablen ändern.

Kategorie

Sonstige

Syntax

IOSetItem ("Variable", "Zugriffsname", "Item");

Argumente

Variable

Der Name einer beliebigen InTouch-E/A-Variablen.

Zugriffsname

Der Zugriffsname, den die Variable verwenden soll.

Item

Das Item, das die Variable verwenden soll.

Die Argumente Variable, Zugriffsname und Item können als literale Zeichenfolgen oder als Zeichenfolgen angegeben werden, die von anderen InTouch-Variablen oder -Funktionen übergeben werden.

Beispiele

Im folgenden Beispiel wird der E/A-Verweis (Punktfeld .Reference) der Variablen PumpeP1 auf den Zugriffsnamen "excel" und das Item "Z1S1" gesetzt.

IOSetItem("PumpeP1", "excel", "Z1S1");

oder

Zahl = 1;

VarName = "PumpeP" + Text(Zahl, "#");

IOSetItem(VarName, "excel", "Z1S1");

Wird eine leere Zeichenfolge ("") sowohl für den Zugriffsnamen als auch für das Item angegeben, ist die Variable deaktiviert. Im folgenden Beispiel wird die Variable PumpeP2 auf diese Weise deaktiviert:

IOSetItem("PumpeP2", "", "");

Bei Angabe einer leeren Zeichenfolge nur für das Item wird der aktuelle Item-Wert der Variablen beibehalten und nur der Zugriffsname aktualisiert. Durch folgende Anweisung wird beispielsweise der Zugriffsname für die Variable PumpeP3 auf "excel2" geändert, ohne das aktuelle Item zu ändern:

IOSetItem("PumpeP3", "excel2", "");

Entsprechend wird bei Angabe einer leeren Zeichenfolge nur für den Zugriffsnamen der aktuelle Zugriffsname der Variablen beibehalten und nur der Item-Wert aktualisiert. Durch folgende Anweisung wird beispielsweise das Item für die Variable PumpeP4 auf "Z1S2" geändert, ohne den Zugriffsnamen zu ändern:

IOSetItem("PumpeP4", "", "Z1S2");