Méthodes de l’émulateur BlueZone

Les méthodes de l’émulateur BlueZone vous permettent d’automatiser des tâches sur l’émulateur BlueZone. Par exemple, vous pouvez capturer du texte à partir de l’écran de l’émulateur sous la forme d’un tableau et insérer le texte dans une feuille Excel.

Méthodes au niveau de l’écran

GetFieldText

Renvoie le texte de la ligne et de la colonne que vous spécifiez.

Tableau 1. Paramètres de la méthode GetFieldText

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Ligne	Numéro de ligne dans l’écran de l’émulateur.	Données entrantes	Entier	Aucun	Oui
Colonne	Numéro de colonne dans l’écran de l’émulateur.	Données entrantes	Entier	Aucun	Oui
Retour	Renvoie le texte de la ligne et de la colonne.	Données sortantes	Chaîne	N/A	N/A

GetTextFromRect

Renvoie le texte d’une plage spécifiée de lignes et de colonnes qui existent dans une zone rectangulaire sur l’écran de l’émulateur. L’image montre une zone rectangulaire à l’écran, ainsi que les lignes et colonnes de début et de fin.

Tableau 2. Paramètres de la méthode GetTextFromRect

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Ligne de départ	Numéro de la ligne qui existe au début de la zone rectangulaire.	Données entrantes	Entier	N/A	Oui
StartCol (en anglais seulement)	Numéro de la colonne qui existe au début de la zone rectangulaire.	Données entrantes	Entier	N/A	Oui
Ligne de fin	Numéro de la ligne qui existe à la fin de la zone rectangulaire.	Données entrantes	Entier	N/A	Oui
EndCol	Numéro de la colonne qui existe à la fin de la zone rectangulaire.	Données entrantes	Entier	N/A	Oui
Retour	Renvoie le texte.	Données sortantes	Chaîne	N/A	N/A

IsCreated (Créé par le système)

Vérifie si l’écran de l’émulateur est actif.

Tableau 3. Paramètres de la méthode IsCreated

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
MatchAllChildren (en anglais seulement)	Paramètre qui permet à la méthode de trouver l’écran de l’émulateur en faisant correspondre ses éléments enfants.	Données entrantes	Booléen	Faux	Oui	Avertissement : L’utilisation de cette option peut retarder l’exécution de la méthode.
Retour	Renvoie la valeur booléenne selon que la méthode d’écran est active ou non.	Données sortantes	Booléen	N/A	N/A

SearchText

Renvoie la colonne et la ligne dans lesquelles se trouve le texte que vous spécifiez.

Tableau 4. Paramètres de la méthode SearchText

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Texte	Texte que la méthode recherche.	Données entrantes	Chaîne	N/A	Oui	Le texte que vous spécifiez est sensible à la casse.
Ligne	Numéro de ligne dans lequel réside le texte spécifié.	Données sortantes	Entier	N/A	N/A	Si le texte que vous spécifiez apparaît sur plusieurs lignes et colonnes, la méthode renvoie la première ligne et la première colonne contenant le texte.
Col	Numéro de colonne dans lequel réside le texte spécifié.	Données sortantes	Entier	N/A	N/A	Si le texte que vous spécifiez apparaît sur plusieurs lignes et colonnes, la méthode renvoie la première ligne et la première colonne contenant le texte.

SendKeys (Envoyer des clés)

Insère les frappes que vous saisissez à partir du clavier sur l’émulateur.

Remarque :

Utilisez la méthode SetCursorPosition avant d’utiliser cette méthode.

Tableau 5. Paramètres de la méthode SendKeys

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Clés	Frappes que vous saisissez à partir de votre clavier.	Données entrantes	Chaîne	Aucun	Oui

SendKeysSécurisé

Envoie les clés chiffrées à la position du curseur que vous spécifiez sur l’écran de l’émulateur.

Remarque :

Utilisez la méthode SetCursorPosition avant d’utiliser cette méthode.

Tableau 6. Paramètres de la méthode SendKeys

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Clés	Frappes que vous saisissez à partir de votre clavier.	Données entrantes	Chaîne sécurisée	Aucun	Oui	Conseil : Pour en savoir plus sur les frappes de l’émulateur BlueZone, reportez-vous à la section https://www3.rocketsoftware.com/bluezone/help/v50/en/bz/DISPLAY/OPTIONS/MF/MF_Key_Mapping.htm.

SetCursorPosition

Définit le curseur sur la ligne et la colonne spécifiées sur l’écran de l’émulateur.

Tableau 7. Paramètres de la méthode SetCursorPosition

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Ligne	Option permettant de fournir le numéro de la ligne à laquelle la méthode place le curseur.	Données entrantes	Entier	N/A	N/A
Col	Option permettant de fournir le numéro de la colonne à laquelle la méthode place le curseur.	Données entrantes	Entier	N/A	N/A

SetFieldText

Définit le texte dans la ligne et la colonne spécifiées que vous spécifiez.

Tableau 8. Paramètres de la méthode SetCursorPosition

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Ligne	Numéro de la ligne dans laquelle vous voulez placer le texte.	Données entrantes	Entier	Aucun	Oui	La méthode remplace le texte existant, le cas échéant.
Colonne	Numéro de la colonne dans laquelle vous voulez placer le texte.	Données entrantes	Entier	Aucun	Oui	La méthode remplace le texte existant, le cas échéant.

AttendreCréer

Attend que l’écran de l’émulateur soit disponible.

Tableau 9. Paramètres de la méthode WaitForCreate

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
timeoutInSeconds	L’opération de méthode expire après la durée que vous spécifiez.	Données entrantes	Entier	30 secondes	Oui
MatchAllChildren (en anglais seulement)	Correspond aux éléments de l’écran que vous avez capturés, le cas échéant.	Données entrantes	Booléen	Faux	Oui	Avertissement : L’utilisation de cette option peut retarder l’exécution de la méthode.
Retour	Renvoie la valeur booléenne qui indique si l’écran de l’émulateur est disponible.	Données sortantes	Booléen	N/A	N/A

Méthodes au niveau des éléments

GetAsTable (Obtenir une table)

Renvoie le texte dans l’élément que vous avez capturé dans une table.

Tableau 10. Paramètres de la méthode GetAsTable

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie le texte dans l’élément d’une table.	Données sortantes	Table de données	N/A	N/A

Gettext

Renvoie le texte dans l’élément que vous avez capturé.

Tableau 11. Paramètres de la méthode GetText

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie le texte dans l’élément.	Données sortantes	Chaîne	N/A	N/A

IsCreated (Créé par le système)

Renvoie la valeur booléenne qui indique si l’élément est disponible.

Tableau 12. Paramètres de la méthode IsCreated

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie la valeur booléenne qui indique si l’élément est disponible.	Données sortantes	Booléen	N/A	N/A

Définir le texte

Définit le texte que vous spécifiez pour l’élément.

Tableau 13. Paramètres de la méthode IsCreated

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Texte	Texte défini par la méthode sur l’élément.	Données entrantes	Chaîne	Aucun	Oui	La méthode remplace le texte existant, le cas échéant.

AttendreCréer

Attend que l’élément soit disponible.

Tableau 14. Paramètres de la méthode WaitForCreate

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
timeoutInSeconds	L’opération de méthode expire après la durée que vous spécifiez.	Données entrantes	Entier	30 secondes	Oui
Retour	Renvoie la valeur booléenne qui indique si l’élément est disponible.	Données sortantes	Booléen	N/A	N/A