Fonction GetWindowName()

Extrait le nom de la fenêtre sous laquelle la fonction a été appelée.

Syntaxe

La syntaxe de la fonction de script est la suivante :

resultcode = GetWindowName(tagname);

Resultcode indique la réussite ou l'échec de la fonction de script. La valeur de resultcode peut être du type Discret/Entier/Réel. Resultcode vaut 1 ou 0, en fonction de la réussite ou de l'échec de la fonction de script :

• Resultcode vaut 1 quand la fonction de script est invoquée dans le contexte d'une fenêtre.

• Resultcode vaut 0 quand la fonction de script est invoquée hors du contexte d'une fenêtre.

  Remarque : La configuration de la valeur renvoyée par la fonction de script est facultative. Ceci est similaire aux autres fonctions de scripts existantes dans InTouch.

Paramètre

TagName

Le nom de variable (tagname) est le paramètre de sortie de la fonction. Il s'agit d'une variable de type message où est récupéré le nom de la fenêtre.

Le paramètre de la fonction peut être n'importe laquelle des suivants :

• Variable InTouch

• .Champ

• Variable locale dans le script

• Référence de variable distante

• Référence Galaxy

Le code par défaut chargé par l'explorateur de scripts est :

GetWindowName(TagName);

Remarque : « TagName » est une variable de message ou une référence de variable distante (RVD) de type message.

Valeur retour

La fonction de script GetWindowName renvoie le nom de fenêtre avec une valeur retour de 1 dans les scénarios suivants :

• Scripts de fenêtre (tous types de condition)

• Scripts d'action de bouton tactile (tous types de condition)

La fonction de script GetWindowName renvoie une chaîne vide avec une valeur retour de 0 dans les scénarios suivants :

• Scripts d'application

• Scripts de clavier

• Scripts de condition

• Scripts sur changement de valeur

• Scripts d'événement ActiveX

• Quick fonction de scripts (synchrones et asynchrones)