Méthodes de l’émulateur IBM PCOMM

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

    • Les méthodes de l’émulateur IBM PCOMM vous permettent d’automatiser des tâches sur l’émulateur IBM PCOMM. 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 tout le texte d’un champ après l’avoir identifié en fonction du numéro de ligne et de colonne que vous spécifiez. La ligne et la colonne font partie du champ. L’image montre que, bien que vous spécifiiez le numéro de ligne et de colonne de la lettre A, la méthode renvoie le texte AMD64 car il fait partie du champ.

    Champ dans l’écran.

    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 la ligne dans le champ de l’écran terminal en fonction de laquelle la méthode identifie le champ. Données entrantes Entier N/A Oui
    Colonne Numéro de la colonne dans le champ de l’écran terminal en fonction de laquelle la méthode identifie le champ. Données entrantes Entier N/A Oui
    Retour Renvoie le texte complet dans le champ. Données sortantes Chaîne. N/A N/A

    GetTextFromRect

    Renvoie le texte d’une zone rectangulaire imaginaire sur l’écran. Pour spécifier la zone rectangulaire, indiquez les numéros de ligne et de colonne de début et de fin. L’image montre une zone rectangulaire sur l’écran et 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 ligne au début de la zone rectangulaire. Données entrantes Entier N/A Oui
    StartCol (en anglais seulement) Numéro de colonne au début de la zone rectangulaire. Données entrantes Entier N/A Oui
    Ligne de fin Numéro de ligne à la fin de la zone rectangulaire. Données entrantes Entier N/A Oui
    EndCol Numéro de colonne à la fin de la zone rectangulaire. Données entrantes Entier N/A Oui
    Retour Renvoie tout le texte de la zone rectangulaire imaginaire. 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) Option permettant à 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 ralentir la méthode.
    Retour Renvoie la valeur booléenne selon que l’écran de l’émulateur est actif ou non. Données sortantes Booléen N/A N/A

    SearchText

    Renvoie les numéros de la ligne et de la colonne qui contient le premier caractère du texte que vous spécifiez. Par exemple, si vous spécifiez l’émulateur de chaîne, la méthode renvoie les numéros de ligne et de colonne du caractère e
    Remarque :
    Si vous fournissez du texte qui s’étend sur plusieurs champs, les ports Ligne et Col renvoient 0, car la méthode ne prend en charge que le texte d’un seul champ.
    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 la ligne qui contient le premier caractère du texte que vous spécifiez. 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 la colonne qui contient le premier caractère du texte que vous spécifiez. 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)

    Simule les frappes au niveau de la position de la souris sur l’écran de l’émulateur que vous entrez à partir du clavier. Par exemple, vous pouvez simuler la frappe Entrée à l’écran.

    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
    Conseil :
    Pour en savoir plus sur les frappes de l’émulateur IBM PCOMM, reportez-vous à la section https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    SendKeysSécurisé

    Simule les frappes chiffrées à la position de la souris 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 IBM PCOMM, reportez-vous à la section https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    SetCursorPosition

    Définit la souris 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 affiche la souris à l’écran. Données entrantes Entier N/A N/A
    Col Option permettant de fournir le numéro de la colonne à laquelle la méthode place la souris sur l’écran. Données entrantes Entier N/A N/A

    AttendreCréer

    Attend que l’écran de l’émulateur devienne actif pendant la durée spécifiée.
    Tableau 8. 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 Nombre de secondes après lesquelles la méthode expire. Données entrantes Entier 30 Oui
    MatchAllChildren (en anglais seulement) Option permettant à la méthode d’attendre que l’écran de l’émulateur devienne actif en faisant correspondre les éléments d’écran. 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 l’écran de l’émulateur est devenu actif ou non. Données sortantes Booléen N/A N/A

    Méthodes au niveau du champ

    Pour accéder aux méthodes au niveau du champ, double-cliquez sur le champ ou la table que vous avez capturé. Les méthodes s’affichent dans le volet Explorateur d’objets .

    Méthodes au niveau du champ.

    GetAsTable (Obtenir une table)

    Renvoie le texte capturé à partir de l’écran du terminal sous forme de tableau. Idéalement, vous devriez utiliser cette méthode lorsque vous capturez des données à partir d’un écran sous la forme d’une table. Toutefois, vous pouvez également l’utiliser pour les données que vous capturez en tant que champ. Pour apprendre à capturer des données sous forme de table, reportez-vous à IBM Émulateur PCOMM.
    Tableau 9. 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 capturé à partir de l’écran du terminal sous forme de tableau. Données sortantes Table de données N/A N/A Pour afficher la table, cliquez avec le bouton droit sur le paramètre et sélectionnez Prévisualiser les données.

    Gettext

    Renvoie le texte que vous avez capturé à partir de l’écran de l’émulateur. Idéalement, vous devriez utiliser cette méthode lorsque vous capturez des données à partir d’un écran en tant que champ.
    Remarque :
    Si vous utilisez cette méthode pour un tableau que vous avez capturé, elle renvoie le texte dans le premier champ de la zone rectangulaire imaginaire.
    Tableau 10. 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 du champ capturé. Données sortantes Chaîne N/A N/A Pour afficher la table, cliquez avec le bouton droit sur le paramètre et sélectionnez Prévisualiser les données.

    IsCreated (Créé par le système)

    Vérifie si l’élément est actif.
    Tableau 11. 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 selon que l’élément est actif ou non. Données sortantes Booléen N/A N/A

    Définir le texte

    Définit le texte personnalisé dans le champ ou la table. Le texte personnalisé remplace le texte existant, le cas échéant.
    Tableau 12. Paramètres de la méthode SetText
    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 vous souhaitez définir dans le champ ou la table. Données entrantes Chaîne N/A Oui

    AttendreCréer

    Attend que l’élément devienne actif pendant le temps que vous spécifiez.
    Tableau 13. 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 Nombre de secondes après lesquelles la méthode expire. Données entrantes Entier 30 Oui
    Retour Renvoie la valeur booléenne selon que l’élément devient actif ou non. Données sortantes Booléen N/A N/A