Fonction WWPoke()

Écrit des données dans un élément d'une application. Vous pouvez l'utiliser, par exemple, pour écrire une valeur dans une cellule de feuille de calcul Excel.

Important : La fonction WWPoke() ne fonctionne pas sur les versions 64 bits du système d'exploitation Windows.

Syntaxe

result = WWPoke (appname, topic, item, string)

Paramètres

appname

Nom de l'application. Chaîne littérale, variable message ou expression chaîne.

topic

Le nom de la rubrique dans l'application. Chaîne littérale, variable message ou expression chaîne.

item

Le nom de l'élément appartenant à la rubrique et à l'application. Chaîne littérale, variable message ou expression chaîne.

string

La valeur à écrire. Chaîne littérale, variable message ou expression chaîne. Les fonctions StringFromIntg(), StringFromReal() ou Text() permettent de convertir la valeur d'une variable entière ou réelle en une variable message.

Valeur retour

Une valeur -1, 0 ou 1 pour indiquer :

-1 - échec d'écriture des données. Les causes peuvent être que l'application n'est pas en cours d'exécution, ou que la rubrique ou l'élément n'existe pas.

0 - échec d'écriture des données, l'application est occupée.

1 - écriture des données réussie.

Remarques

N'utilisez pas les fonctions WWPoke() ou WWRequest() pour lire ou écrire des données entre applications InTouch de postes différents ou de sessions différentes. À la place, utilisez des noms d'accès pour lire ou écrire des données entre des applications InTouch. Voir Configuration de noms d’accès.

Exemple(s)

Ce script place la valeur de la variable réelle CellValue dans une variable message Mtag et écrit cette valeur dans la cellule de la ligne 1, colonne 1 de la feuille Feuil1 du classeur Classeur1.xls de Microsoft Excel.

MTag = Text(CellValue,"0");

Result = WWPoke("excel","[Book1.xls]sheet1", "r1c1",Mtag);