Funktion GetWindowName()

Sie gibt den Namen des Fensters zurück, aus dem sie aufgerufen wurde.

Syntax

Die Syntax der Funktion lautet wie folgt:

resultcode = GetWindowName(tagname);

In die Variable Resultcode wird zurückgegeben, ob der Aufruf der Funktion erfolgreich war. Es kann sich hierbei um eine Binär-, Integer- oder Real-Variable handeln. Die möglichen Ergebniswerte 1 oder 0 haben die folgende Bedeutung:

• Resultcode = 1: Die Skriptfunktion wurde aus einem Fenster aufgerufen.

• Resultcode = 0: Die Skriptfunktion wurde nicht aus einem Fenster aufgerufen.

  Hinweis: Die Verwendung des Rückgabewerts ist optional (ähnlich wie bei anderen InTouch-Skriptfunktionen).

Parameter

TagName

Variable ist eine Meldungsvariable, in die der Fenstername geschrieben wird.

Sie können hier einen der folgenden Verweise angeben:

• InTouch-Variable

• Punktfeld

• Lokale Variable im Skript

• Fernverweis

• Galaxy-Verweis

Bei der Auswahl der Skriptfunktion im Editor wird standardmäßig der folgende Aufruf eingefügt:

GetWindowName(TagName);

Hinweis: Ersetzen Sie "TagName" durch den Namen einer Meldungsvariablen oder durch einen Fernverweis auf eine Meldungsvariable.

Rückgabewert

GetWindowName gibt den Fensternamen und den Ergebniscode 1 zurück, wenn es aus den folgenden Arten von Skripten aufgerufen wird:

• Fensterskripte (alle Auslöser)

• Aktionsskripte (alle Auslöser)

GetWindowName gibt eine leere Zeichenfolge und den Ergebniscode 0 zurück, wenn es aus den folgenden Arten von Skripten aufgerufen wird:

• Projektskripte

• Tastenskripte

• Konditionalskripte

• Datenänderungsskripte

• ActiveX-Ereignisskripte

• QuickFunctions (synchron oder asynchron)