Méthodes de l’émulateur BlueZone

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

    • 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.

    Zone rectangulaire sur un écran.

    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