IBM Méthodes d’émulateur de communications personnelles
Utilisez les méthodes de l’émulateur Personal IBM Communications pour effectuer diverses tâches d’automatisation sur l’émulateur IBM Personal Communications.
Méthodes au niveau de l’écran
Utilisez des méthodes au niveau de l’écran pour effectuer les tâches d’automatisation sur l’écran de l’émulateur. Par exemple, vous pouvez simuler une commande à l’écran ou obtenir du texte à partir de l’écran.
Obtenir du texte sur le champ
Renvoie le texte qu’un champ contient après avoir identifié le champ à l’aide du numéro de ligne et de colonne que vous spécifiez. La ligne et la colonne que vous spécifiez constituent le point de départ du champ. La méthode identifie l’ensemble du champ, puis renvoie le texte dans le champ. Dans l’exemple suivant, H est la première lettre et le point de départ dans le champ et Host OS : est le texte complet dans le champ.
| 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 de champ qui identifie le champ. | Données dans | Entier | N/A | Oui | |
| Colonne | Numéro de colonne de champ qui identifie le champ. | Données dans | Entier | N/A | Oui | |
| Retour | Renvoie le texte dans le champ. | Sortie de données | Chaîne | N/A | N/A |
GetTextFromRect
Renvoie le texte dans tous les champs d’une zone rectangulaire que vous définissez à l’écran. Vous définissez une zone en fournissant les lignes de début et de fin et les numéros de colonne. La méthode localise et identifie le premier et le dernier champ et renvoie tout le texte dans tous les champs de cette zone. L’exemple suivant montre la zone que vous avez définie.
| 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 qui indique le premier caractère du premier champ de la zone rectangulaire. | Données dans | Entier | N/A | Oui | |
| StartCol (en anglais seulement) | Numéro de colonne qui contient le premier caractère du premier champ de la zone rectangulaire. | Données dans | Entier | N/A | Oui | |
| Ligne de fin | Numéro de ligne contenant le dernier caractère du dernier champ de la zone rectangulaire. | Données dans | Entier | N/A | Oui | |
| Col de fin | Numéro de colonne contenant le dernier caractère du dernier champ de la zone rectangulaire. | Données dans | Entier | N/A | Oui | |
| Retour | Renvoie le texte de tous les champs de la zone rectangulaire. | Sortie de données | Chaîne | N/A | N/A |
IsCreated (Créé le )
Vérifie si l’écran de l’émulateur existe en fonction de la règle de correspondance d’écran et peut accepter les entrées de l’utilisateur. Après vérification, la méthode renvoie la valeur booléenne appropriée.
| 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 de trouver l’écran de l’émulateur en faisant correspondre les éléments enfants que vous avez capturés. | Données dans | 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 existe ou non en fonction de la règle de correspondance d’écran et peut accepter des entrées de l’utilisateur. | Sortie de données | Booléen | N/A | N/A |
SearchText
l’émulateur de chaîne, la méthode renvoie les numéros de ligne et de colonne du point de départ de l’émulateur de mots qui est e.| Paramètre | Description | Type d’entrée de port de données | Type de données | Valeur par défaut | Obligatoire | Notes |
|---|---|---|---|---|---|---|
| Texte | Texte recherché par la méthode. | Données dans | Chaîne | N/A | Oui | Le texte que vous spécifiez peut être sensible à la casse en fonction de l’émulateur que vous utilisez. |
| Ligne | Numéro de ligne contenant le premier caractère du texte que vous spécifiez. | Sortie de données | Entier | N/A | N/A | Si le texte que vous spécifiez se trouve sur plusieurs lignes et colonnes, la méthode renvoie la première ligne et la première colonne qui contient le texte. |
| Col | Numéro de colonne qui contient le premier caractère du texte que vous spécifiez. | Sortie de données | Entier | N/A | N/A | Si le texte que vous spécifiez se trouve sur plusieurs lignes et colonnes, la méthode renvoie la première ligne et la première colonne qui contient le texte. |
SendKeys (Envoyer des clés)
Simule les frappes que vous saisissez à partir du clavier à la position du périphérique de la souris sur l’écran de l’émulateur. Par exemple, vous pouvez simuler la frappe de la touche [Entrée] à l’écran.
| 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 dans | Chaîne | Aucun | Oui |
Conseil :
Pour en savoir plus sur les frappes au clavier, reportez-vous à la documentation de l’émulateur de terminal respectif. |
SendKeysSecure
Simule la frappe au clavier qui est une chaîne sécurisée à la position du périphérique de la souris sur l’écran de l’émulateur.
| 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 clavier que vous saisissez en tant que chaîne sécurisée. | Données dans | Chaîne sécurisée | Aucun | Oui |
Conseil :
Pour en savoir plus sur les frappes au clavier, reportez-vous à la documentation de l’émulateur de terminal respectif. |
Définir CursorPosition
Tente de définir le périphérique de la souris sur le numéro de ligne et de colonne que vous spécifiez.
| 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 sur la base de laquelle la méthode tente de définir le périphérique de souris sur l’écran. | Données dans | Entier | N/A | N/A | Le numéro de ligne doit être positif et dans la taille de l’écran de l’émulateur. Par exemple, si la taille de l’écran est 24X80, la valeur maximale que vous pouvez fournir pour une ligne est 24. |
| Col | Option permettant de fournir le numéro de la ligne sur la base de laquelle la méthode tente de définir le périphérique de souris sur l’écran. | Données dans | Entier | N/A | N/A | Le numéro de colonne doit être positif et dans la taille de l’écran de l’émulateur. Par exemple, si la taille de l’écran est de 24X80, la valeur maximale que vous pouvez fournir pour une colonne est 80. |
AttendreCréer
Attend pendant la durée que vous spécifiez pendant que le connecteur utilise la règle de correspondance d’écran pour vérifier si l’écran existe.
| Paramètre | Description | Type d’entrée de port de données | Type de données | Valeur par défaut | Obligatoire | Notes |
|---|---|---|---|---|---|---|
| timeoutinSeconds | Option permettant de fournir le nombre de secondes pendant lesquelles la méthode attend pendant que le connecteur utilise la règle de correspondance d’écran pour déterminer si l’écran existe. | Données dans | Entier | 30 | Oui | |
| MatchAllChildren (en anglais seulement) | Option permettant de faire correspondre tous les éléments d’écran que vous avez capturés pour trouver si l’écran existe. | Données dans | 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 a été trouvé ou non. | Sortie de données | Booléen | N/A | N/A |
Méthodes au niveau de l’élément
Les méthodes au niveau de l’élément effectuent des tâches d’automatisation sur les éléments de l’écran de l’émulateur que vous ajoutez à partir de l’écran Connecteur de terminal. Vous pouvez ajouter un élément d’écran sous la forme d’un champ ou d’une table.
Obtenir une table
Renvoie le texte que vous avez capturé en tant qu’objet de table de données. Utilisez cette méthode lorsque vous capturez les données d’un écran sous forme de table. Toutefois, vous pouvez également utiliser cette méthode pour les données que vous capturez en tant que champ. Pour apprendre à capturer les données sous forme de table, reportez-vous à la section Configurer l’émulateur IBM Personal Communications.
| 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 en tant qu’objet de table de données. | Sortie de données | 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. |
Obtenir du texte
Renvoie le texte dans le champ que vous avez capturé à partir de l’écran de l’émulateur. Si vous utilisez cette méthode pour une table que vous avez capturée, elle renvoie le texte dans le premier champ du rectangle.
| 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é. | Sortie de données | Chaîne | N/A | N/A |
IsCreated (Créé le )
Correspond aux règles et vérifie si l’élément capturé existe.
| 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. | Sortie de données | Booléen | N/A | N/A |
Définir le texte
Tente de définir le texte sur le champ.
| Paramètre | Description | Type d’entrée de port de données | Type de données | Valeur par défaut | Obligatoire | Notes |
|---|---|---|---|---|---|---|
| Texte | Option permettant de spécifier le texte que la méthode tente de définir dans le champ. | Données dans | Chaîne | N/A | Oui | Vous ne pouvez pas utiliser cette méthode sur les écrans d’émulateur protégés. |
AttendreCréer
Attend la durée que vous spécifiez pendant que le connecteur utilise la règle de correspondance pour déterminer si l’élément existe.
| Paramètre | Description | Type d’entrée de port de données | Type de données | Valeur par défaut | Obligatoire | Notes |
|---|---|---|---|---|---|---|
| timeoutinSeconds | Option permettant de fournir le nombre de secondes pendant lesquelles la méthode attend pendant que le connecteur utilise la règle de correspondance pour déterminer si l’élément existe. | Données dans | Entier | 30 | Oui | |
| Retour | Renvoie la valeur booléenne selon que l’élément a été trouvé ou non. | Sortie de données | Booléen | N/A | N/A |