Application event trigger

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

Description

Configure un déclencheur basé sur un événement natif de n'importe quel type d'élément (fenêtre de niveau supérieur ou tout autre élément d'IU indiqué). Vous pouvez indiquer l'élément cible à l'écran, puis choisir l'événement natif dans la liste des événements pris en charge par cet élément.

Cette activité est compatible avec le référentiel d’objets.

Le déclencheur doit être la première activité du workflow et le workflow est déclenché lorsqu'un événement d'IU se produit. Un seul déclencheur par workflow est autorisé. Pour plus de détails, consultez Automatisation Attended basée sur déclencheur.

Remarque :

Si vous utilisez une version de Studio antérieure à 2023.4, vous devez placer l’activité Déclencheur d'événement d' application (Application Event Trigger ) à l’intérieur d’une activité Étendue du déclencheur (Trigger Scope ). Dans ce cas, l’activité Déclencheur d'événement d'application ( Application Event Trigger ) n’affiche pas le Mode de planification ( Scheduling mode ) et les propriétés Activé (Enabled), et la propriété Mode de planification ( Scheduling mode ) est disponible dans l’activité Étendue du déclencheur ( Trigger Scope ).

Compatibilité du projet

Windows - Héritage | Fenêtres

Windows - Héritage, configuration Windows

Module Designer

• Cliquez sur Indiquer la cible à l'écran pour indiquer l'élément d'IU à utiliser comme cible.

  Après avoir indiqué la cible, sélectionnez le menu pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Type d'événement (Event type ) : la liste des types d'événements natifs spécifiques à l'élément indiqué. Le type d’événement doit être défini. La liste des événements exposés dépend du type d'élément cible et de la technologie d'application cible. Par exemple, un élément d'IU Web peut exposer une liste d'événements différente de celle d'un élément d'IU Java.

Panneau propriétés

Commun

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

Entrée

• Match sync - Indique si la correspondance du sélecteur d'élément cible est effectuée de manière synchrone ou asynchrone. Elle est prise en charge uniquement pour les événements Java, à l'exception de Apparu ( Appeared) et Disparu(Disappeared) . Ce champ prend uniquement en charge les valeurs Boolean . La valeur par défaut est False.
• Sélecteurs ( Selectors ) - Collection facultative de sélecteurs à surveiller pour l'événement indiqué ; ces sélecteurs sont surveillés avec la cible indiquée. Les sélecteurs doivent être des sélecteurs complets (pas partiels).

• Cible (Target) : l'élément cible : fenêtre de niveau supérieur ou élément d'IU. Seuls les sélecteurs stricts sont pris en charge, sans ancres. L’élément cible doit être défini. Avant d'être indiqué à l'écran, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l'élément qui a été indiqué sont affichées.
  • Sélecteur strict : le sélecteur strict généré pour l'élément d'IU cible. Il est vide pour les fenêtres de niveau supérieur.
  • Sélecteur de fenêtre (instance d’application) : le sélecteur pour la fenêtre d’application (application/navigateur).

Divers

• Activé ( Enabled ) : si défini sur Faux ( False), le déclencheur démarre mais ne déclenche aucun événement. Il peut être activé ultérieurement au moment de l'exécution, en utilisant l'activité Enable Local Trigger . Cette propriété est masquée lorsque l'activité Déclencheur d'événement d'application ( Application Event Trigger ) est placée à l'intérieur d'une activité Étendue du déclencheur ( Trigger Scope). Ce champ prend uniquement en charge les valeurs Boolean . La valeur par défaut est Vrai(True).
• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Inclure les enfants : lorsque cette option est sélectionnée, les enfants de l'élément de l'interface utilisateur spécifié sont également surveillés. Il prend en charge tous les types d'événements à l'exception de Apparu ou Disparu et de tout élément d'IU à l'exception des fenêtres de niveau supérieur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.
• Mode de planification (Scheduling mode ) : spécifie comment exécuter les Actions lorsqu'un déclencheur est exécuté. Choisissez l'une des cinq options dans le menu déroulant :
  • Séquentiel (Sequential) : les actions sont exécutées les unes après les autres.
  • Simultané (Concurrent) : l'exécution des actions peut se chevaucher.
  • Unique (OneTime) : exécute une action et quitte la surveillance.
  • Réduction séquentielle (Sequential Collapse) : ignore tous les événements à venir, sauf le plus récent, jusqu’à ce que l’exécution de l’événement actuel soit terminée.
  • Arrêt séquentiel (Sequential Drop) : arrête l’exécution de l’événement précédent et démarre l’événement suivant.

  Pour les modes Séquentielles et Simultanées , la surveillance se poursuit jusqu'à ce que l'utilisateur arrête l'exécution ou qu'une activité Interrompre soit exécutée.

Événements natifs

À propos

Le mécanisme de surveillance des événements natif a été amélioré en implémentant de nouveaux ensembles d’événements pris en charge par différents types de technologies d’application :

• Événements WND natifs

• Événements natifs CTRL

• Événements JAVA natifs

• Événements natifs WEBCTRL

• Événements HTML natifs

• Événements UIA natifs

Événements WND : fenêtre supérieure

Type d'événement	Type TriggerEventArgs	Description
Apparu	ArgVides	Événement déclenché lorsque l'élément cible apparaît.
Disparu	ArgVides	Événement déclenché lorsque l'élément cible disparaît.
Titre modifié	ArgumentsModifiésTexte	Événement déclenché lorsque le titre de l'élément cible change. Remarque : il s'agit de l'événement Texte modifié , renommé Titre modifié pour les fenêtres de niveau supérieur, pour plus de clarté.
État modifié	ArgsModifiésÉtat	Événement déclenché lorsque l'état de l'élément cible change. Remarque : cet événement est déclenché lorsque quelque chose est modifié dans l'état de la fenêtre : activé, désactivé, coché, décoché, ciblable, focalisé, visible, etc. La nouvelle valeur de l'état est exposée dans la variable d'arguments.
Emplacement modifié	ArgumentsModifiésEmplacement	Événement déclenché lorsque l'emplacement de l'élément de la cible a changé.
Premier plan obtenu	HwndArgs	Événement déclenché lorsque la fenêtre d'élément de la cible devient la fenêtre de premier plan.
Premier plan perdu	HwndArgs	Événement déclenché lorsque la fenêtre d'élément de la cible n'est plus au premier plan.
Réduit	HwndArgs	Événement déclenché lorsque la fenêtre d'élément de la cible est sur le point d'être réduite.
restauré	HwndArgs	Événement déclenché lorsque la fenêtre d'élément de la cible est sur le point d'être restaurée.

Événements CTRL ou événements WND – éléments d’IU

Type d'événement	Type TriggerEventArgs	Description
Apparu	ArgVides	Événement déclenché lorsque l'élément cible apparaît.
Disparu	ArgVides	Événement déclenché lorsque l'élément cible disparaît.
Texte modifié	ArgumentsModifiésTexte	Événement déclenché lorsque le texte de l'élément cible change.
Focus atteint	ArgVides	Événement déclenché lorsque l'élément cible atteint le focus.
Mise au point perdue	ArgVides	Événement déclenché lorsque l'élément cible perd le focus.
État modifié	ArgsModifiésÉtat	Événement déclenché lorsque l'état de l'élément cible change. Remarque : cet événement est déclenché lorsque quelque chose est modifié dans l'état de la fenêtre : activé, désactivé, coché, décoché, ciblable, focalisé, visible, etc. La nouvelle valeur de l'état est exposée dans la variable d'arguments.
Sélection modifiée	ArgumentsModifiésSélection	Événement déclenché lorsque la valeur de sélection de l'élément cible change.

Événements JAVA - Éléments d'IU

Type d'événement	Type TriggerEventArgs	Description
Apparu	ArgVides	Événement déclenché lorsque l'élément cible apparaît.
Disparu	ArgVides	Événement déclenché lorsque l'élément cible disparaît.
Texte modifié	ArgumentsModifiésTexte	Événement déclenché lorsque le texte de l'élément cible change.
Touche enfoncée	Java KeyPressArgs	Événement déclenché lorsqu'une touche est enfoncée alors que le focus est à l'intérieur de l'élément cible.
Cliquer (Click)	ArgsActionSourisJava	Événement déclenché lorsqu'un clic est effectué sur l'élément cible.
Souris déplacée	ArgumentsMouvementSourisJava	Événement déclenché lorsque la souris est déplacée sur l'élément cible.
Focus atteint	ArgVides	Événement déclenché lorsque l'élément cible atteint le focus.
Mise au point perdue	ArgVides	Événement déclenché lorsque l'élément cible perd le focus.
Activé (Enabled)	ArgVides	Événement déclenché lorsque l'élément cible est activé.
Désactivé (Disabled)	ArgVides	Événement déclenché lorsque l'élément cible est désactivé.
Sélection modifiée	ArgumentsModifiésSélection	Événement déclenché lorsque la valeur de sélection de l'élément cible change.
Souris entrée	ArgumentsMouvementSourisJava	Événement déclenché lorsque la souris entre dans la partie visible de l'élément cible.
Souris sortie	ArgumentsMouvementSourisJava	Événement déclenché lorsque la souris sort de la partie visible de l'élément cible.
Cellule sélectionnée	ArgCellulesSélectionnéesJava	Événement déclenché lorsque l'élément cible est une cellule de tableau et qu'il est sélectionné.
La valeur de la cellule a été modifiée	ArgsModifiésValeurCelluleJava	Événement déclenché lorsque l'élément cible est une cellule de tableau et que sa valeur est modifiée.
Souris enfoncée	ArgsActionSourisJava	Événement déclenché lorsque la souris est enfoncée sur l'élément cible.
Souris relâchée	ArgsActionSourisJava	Événement déclenché lorsque la souris est relâchée sur l'élément cible.
Menu sélectionné	ArgVides	Événement déclenché lorsque l'élément cible est un menu et qu'il est sélectionné.
Menu désélectionné	ArgVides	Événement déclenché lorsque l'élément cible est un menu et qu'il est désélectionné.
Menu annulé	ArgVides	Événement déclenché lorsque l'élément cible est un menu et qu'il est annulé.
Menu contextuel visible	ArgVides	Événement déclenché lorsque l'élément cible est un menu contextuel et qu'il devient visible.
Menu contextuel invisible	ArgVides	Événement déclenché lorsque l'élément cible est un menu contextuel et qu'il devient invisible.
Menu contextuel annulé	ArgVides	Événement déclenché lorsque l'élément cible est un menu contextuel et qu'il est annulé.

Événements WEBCTRL - Éléments d'IU

Remarque : Depuis UiPath.UIAutomation.Activities v23.10, nous avons ajouté la prise en charge des événements natifs basés sur WEBCTRL dans les navigateurs intégrés natifs (tels que Slack, Discord, Electron).

À partir de UiPath.UIAutomation.Activities v23.12, nous avons ajouté la prise en charge des événements natifs basés sur WEBCTRL dans les navigateurs intégrés gérés (tels que CefSharp).

L'événement Text selection changed est pris en charge pour les navigateurs intégrés à partir de UiPath.UIAutomation.Activities v23.12.

Type d'événement	Type TriggerEventArgs	Description
Apparu	ArgVides	Événement déclenché lorsque l'élément cible apparaît.
Disparu	ArgVides	Événement déclenché lorsque l'élément cible disparaît.
Texte modifié	ArgumentsModifiésTexte	Événement déclenché lorsque le texte de l'élément cible change.
Touche enfoncée	WebKeyPressArgs	Événement déclenché lorsqu'une touche est enfoncée alors que le focus est à l'intérieur de l'élément cible.
Cliquer (Click)	WebMouseEventArgs	Événement déclenché lorsqu'un clic est effectué sur l'élément cible.
Double cliquer	WebMouseEventArgs	Événement déclenché lorsqu'un double-clic est effectué sur l'élément cible.
Cliquer-droit	WebMouseEventArgs	Événement déclenché lorsqu'un clic droit est effectué sur l'élément cible.
Souris déplacée	WebMouseEventArgs	Événement déclenché lorsque la souris est déplacée sur l'élément cible.
Souris enfoncée	WebMouseEventArgs	Événement déclenché lorsque la souris est enfoncée sur l'élément cible.
Souris relâchée	WebMouseEventArgs	Événement déclenché lorsque la souris est relâchée sur l'élément cible.
Souris entrée	WebMouseEventArgs	Événement déclenché lorsque la souris entre dans la partie visible de l'élément cible.
Souris sortie	WebMouseEventArgs	Événement déclenché lorsque la souris sort de la partie visible de l'élément cible.
Focus atteint	ArgVides	Événement déclenché lorsque l'élément cible atteint le focus.
Mise au point perdue	ArgVides	Événement déclenché lorsque l'élément cible perd le focus.
Sélection de texte modifiée	WebTextSelectionChangedArgs	Événement déclenché lorsque le texte sélectionné de l'élément cible change.

Événements HTML - Éléments d'IU

Remarque : les types d'événements suivants ne sont pris en charge que pour les applications Web identifiées par les sélecteurs <html> qui n'ont que l'attribut app :

• Download state changed

• Tab activated

• Tab created

• Tab removed

• Tab updated

Pour l'instant, ces événements ne sont autorisés que lorsque le sélecteur de fenêtre contient la partie <html>, par exemple : <html app='chrome.exe' />. Les autres attributs tels que title ou url ne sont pas autorisés. Si le sélecteur de fenêtre contient des attributs autres que app, une erreur de runtime est générée.

Le sélecteur strict doit être vide.

Ces types d'événements ne sont pas pris en charge pour les navigateurs intégrés.

Type d'événement	Type TriggerEventArgs	Description
État de téléchargement modifié	DownloadChangedArgs	Événement déclenché lorsque les propriétés d'un élément DownloadItem changent.
Onglet activé	TabActivatedArgs	Événement déclenché lorsque l'onglet actif d'une fenêtre change. Remarque : l'URL de l'onglet n'a peut-être pas été définie au moment du déclenchement de cet événement, mais vous pouvez écouter les événements onUpdated pour être averti lorsqu'une URL est définie.
Onglet créé	TabCreatedArgs	Événement déclenché lorsqu'un onglet est créé. Remarque : l'URL de l'onglet et l'appartenance à un groupe d'onglets peuvent ne pas être définies au moment où cet événement est déclenché, mais vous pouvez écouter les événements onUpdated pour être averti lorsqu'une URL est définie ou que l'onglet est ajouté à un groupe d'onglets.
Onglet supprimé	TabRemovedArgs	Événement déclenché lorsqu'un onglet est fermé.
Onglet mis à jour	TabUpdatedArgs	Événement déclenché lorsqu'un onglet est mis à jour.
La navigation par onglets a commencé	TabNavigationStartedArgs	Événement déclenché lorsque la navigation par onglet vers une URL spécifique a démarré.
Navigation par onglets terminée	TabNavigationCompletedArgs	Événement déclenché lorsque la navigation par onglet vers une URL spécifique est terminée.
Focus de la fenêtre modifié	HtmlWindowFocusChangedArgs	Événement déclenché lorsque la fenêtre actuellement ciblée change.
Limites de la fenêtre modifiées	HtmlWindowBoundsChangedArgs	Événement déclenché lorsqu'une fenêtre a été redimensionnée. Il n'est envoyé que lorsque les nouvelles limites sont validées, et non pour les modifications en cours.
Fenêtre créée	HtmlWindowCreatedArgs	Événement déclenché lorsqu'une fenêtre est créée.
Fenêtre supprimée	HtmlWindowRemovedArgs	Événement déclenché lorsqu'une fenêtre est supprimée (fermée).

Événements UIA - Éléments d'IU

Type d'événement	Type TriggerEventsArgs	Description
Apparu	ArgVides	Événement déclenché lorsque l'élément cible apparaît.
Disparu	ArgVides	Événement déclenché lorsque l'élément cible disparaît.
Texte modifié	ArgumentsModifiésTexte	Événement déclenché lorsque le texte de l'élément cible change.
Sélection de texte modifiée	UiaTextSelectionChangedArgs	Événement déclenché lorsque le texte sélectionné de l'élément cible change.
Focus atteint	ArgVides	Événement déclenché lorsque l'élément cible atteint le focus.
Mise au point perdue	ArgVides	Événement déclenché lorsque l'élément cible perd le focus.
Invoqué	ArgVides	Événement déclenché lorsque l'élément cible est invoqué.
Selected	ArgumentsModifiésSélection	Événement déclenché lorsque l'élément cible est sélectionné.
Désélectionné	ArgumentsModifiésSélection	Événement déclenché lorsque l'élément cible est désélectionné.
a basculé	UiaToggledArgs	Événement déclenché lorsque l'élément cible est activé/désactivé.

Propriétés TriggerEventArgs

TriggerArgs»

Classe de base pour toutes les classes args liées aux déclencheurs.

Propriété	Saisie de texte	Description
TriggerName	Chaîne de caractères (string)	Le nom du déclencheur (affiché en tant que nom d'activité).
TriggerType	Saisie de texte	Le type d'objet TriggerEventArgs.

ArgumentsDéclencheurÉlémentIU

Héritage : TriggerArgs > UiElementTriggerArgs

Propriété	Saisie de texte	Description
Selector	Chaîne de caractères (string)	Le sélecteur de l'élément cible.
TargetElement	UiElement	L'élément cible qui est surveillé.

NativeTriggerBaseArgs

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs

Propriété	Saisie de texte	Description
SelectorIndex	Entier	L'index du sélecteur d'élément cible.

ArgVides

Renvoie les données des événements suivants : Apparu (Appeared), Disparu (Disappeared), Mise au point acquise (Focus gained), Mise au point perdue (Focus lost), Activé (Enabled), Désactivé (Disabled), Menu sélectionné (Menu selected), Menu désélectionné (Menu deselected), Menu annulé (Menu canceled), Menu contextuel visible (Popup menu visible), Menu contextuel invisible (Popup menu invisible), Menu contextuel annulé (Popup menu canceled).

Héritage : TriggerArgs > UiElementTriggerArgs > EmptyArgs

TextChangedArg

Renvoie les données des événements suivants : Texte modifié (Text changed), Titre modifié (Title changed).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TextChangedArgs

Propriété	Saisie de texte	Description
Text	Chaîne de caractères (string)	Le nouveau texte de l'élément cible.

ArgsModifiésÉtat

Renvoie les données des événements suivants : État modifié (State changed).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs

Propriété	Saisie de texte	Description
State	Chaîne de caractères (string)	Le nouvel état de l'élément cible.

ArgumentsModifiésSélection

Renvoie les données des événements suivants : Sélection modifiée (Selection changed).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs

Propriété	Saisie de texte	Description
Selection	Chaîne de caractères (string)	La nouvelle sélection de l'élément cible.

ArgumentsModifiésEmplacement

Renvoie les données des événements suivants : Emplacement modifié (Location changed).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > LocationChangedArgs

Propriété	Saisie de texte	Description
Location	Rectangle	Rectangle de l'emplacement modifié, avec des informations sur la taille de l'élément et sa position.

HwndArgs

Renvoie les données des événements suivants : Premier plan obtenu (Foreground gained), Premier plan perdu (Foreground lost), Réduit (Minimized), Restauré (Restored).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

Propriété	Saisie de texte	Description
Hwnd	IntPtr	Poignée de fenêtre.
HwndAsString	Chaîne de caractères (string)	Poignée de fenêtre sous forme de chaîne.

Java KeyPressArgs

Renvoie les données des événements suivants : Touche enfoncée (Key pressed) (pour Java).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

Propriété	Saisie de texte	Description
KeyChar	Chaîne de caractères (string)	Le caractère correspondant à la touche enfoncée.
KeyCode	Entier	Le code correspondant à la touche enfoncée.
ExtendedKeyCode	Entier	Le code de touche étendu de la touche sur laquelle vous avez appuyé. Contrairement à KeyCode, cette valeur dépend de la disposition du clavier actuelle.
Location	Chaîne de caractères (string)	L'emplacement de la clé qui a généré l'événement.
KeyModifiers	ModificateursCléN	Modificateur de touche utilisé avec la touche. Valeurs possibles : None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

ArgsActionSourisJava

Renvoie les données des événements suivants : Clic (Click), Souris enfoncée (Mouse pressed), Souris relâchée (pour Java).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

Propriété	Saisie de texte	Description
X	Entier	La coordonnée X du pointeur de la souris.
Y	Entier	La coordonnée Y du pointeur de la souris.
Button	Entier	Le bouton de la souris sur lequel il a été cliqué. Valeurs possibles : 1 Gauche 2 : milieu 3 - Droite
ClickCount	Entier	Le nombre de clics effectués sur le bouton.
KeyModifiers	ModificateursCléN	Le modificateur de touche utilisé avec le bouton de la souris. Valeurs possibles : None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

ArgumentsMouvementSourisJava

Renvoie les données des événements suivants : Souris déplacée (Mouse Move), Souris entrée (Mouse entered), Souris sortie (Mouse exited) (pour Java).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

Propriété	Saisie de texte	Description
X	Entier	La coordonnée X du pointeur de la souris.
Y	Entier	La coordonnée Y du pointeur de la souris.
MouseButton	Entier	Le bouton de la souris sur lequel a été cliqué Valeurs possibles : 0 - Aucun 1 Gauche 2 : milieu 3 - Droite

ArgCellulesSélectionnéesJava

Renvoie les données des événements suivants : Clic (Click) (pour Java).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

Propriété	Saisie de texte	Description
Row	Entier	Ligne de cellule sélectionnée.
Column	Entier	Colonne de cellule sélectionnée.

ArgsModifiésValeurCelluleJava

Renvoie les données des événements suivants : Clic (Click) (pour Java).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

Propriété	Saisie de texte	Description
Row	Entier	Ligne de cellule.
Column	Entier	Colonne de cellule.
Value	Chaîne de caractères (string)	Nouvelle valeur de la cellule.

WebMouseEventArgs

Renvoie les données des événements suivants : Clic (Click), Double clic (Double Click), Clic droit (Right click), Souris déplacée (Mouse move), Souris entrée (Mouse entered), Souris sortie (Mouse exited), Souris enfoncée (Mouse pressed), Souris relâchée (Mouse released) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

Remarque : il suit les noms de propriété définis pour les événements de souris.

Propriété	Saisie de texte	Description
AltKey	Booléen	Si la touche ALT est enfoncée.
Button	Entier	Le bouton de la souris sur lequel vous avez appuyé. Valeurs possibles : 0 Gauche 1 : milieu 2 - Droite
ClientX	Entier	La coordonnée X du pointeur de souris (par rapport à la fenêtre).
ClientY	Entier	La coordonnée Y du pointeur de souris (par rapport à la fenêtre).
CtrlKey	Booléen	Si la touche CTRL est enfoncée.
MetaKey	Booléen	Si la touche META est enfoncée.
MovementX	Entier	La coordonnée X du pointeur de souris (par rapport à la position du dernier événement mousemove).
MovementY	Entier	La coordonnée Y du pointeur de souris (par rapport à la position du dernier événement mousemove).
OffsetX	Entier	La coordonnée X du pointeur de souris (par rapport à la cible).
OffsetY	Entier	La coordonnée Y du pointeur de souris (par rapport à la cible).
PageX	Entier	La coordonnée X du pointeur de souris (par rapport au document).
PageY	Entier	La coordonnée Y du pointeur de souris (par rapport au document).
ScreenX	Entier	La coordonnée X du pointeur de la souris (par rapport à l'écran).
ScreenY	Entier	La coordonnée Y du pointeur de souris (par rapport à l'écran).
ShiftKey	Booléen	Si la touche SHIFT est enfoncée.

WebKeyPressArgs

Renvoie les données des événements suivants : Touche enfoncée (Key pressed) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

Remarque : il suit les noms de propriété définis pour les événements de clavier.

Propriété	Saisie de texte	Description
AltKey	Booléen	Si la touche ALT est enfoncée.
Code	Chaîne de caractères (string)	Le code de la touche qui a déclenché l'événement (par exemple, KeyA, KeyB, ControlLeft, ControlRight).
CtrlKey	Booléen	Si la touche CTRL est enfoncée.
IsComposing	Booléen	Si l'état de l'événement est en cours de composition ou non.
Key	Chaîne de caractères (string)	La valeur de la clé qui a déclenché l'événement (par ex. a, b, Control).
Location	Entier	L'emplacement d'une touche sur le clavier ou l'appareil. Valeurs possibles : 0 - Standard - représente presque toutes les touches du clavier 1 : la touche gauche a été enfoncée 2 : la touche droite a été actionnée 3 : la touche a été enfoncée sur le pavé numérique
MetaKey	Booléen	Si la touche META est enfoncée.
Repeat	Booléen	Si une touche est maintenue enfoncée à plusieurs reprises ou non.
ShiftKey	Booléen	Si la touche SHIFT est enfoncée.

WebTextSelectionChangedArgs

Renvoie les données des événements suivants : Sélection du texte modifiée (Text selection changed) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

Remarque : il suit les noms de propriété définis pour les événements de clavier.

Propriété	Saisie de texte	Description
AnchorClientBounds	Rectangle	Les limites du client d'ancrage : informations sur la taille de l'élément et sa position par rapport à la fenêtre d'affichage.
AnchorElement	UiElement	L'élément d'IU d’ancrage.
AnchorOffset	Entier	L'index de base 0 du caractère où la sélection de texte a commencé (à partir du texte intégral de l'élément cible).
FocusClientBounds	Rectangle	Les limites du client de mise au point : informations sur la taille de l'élément et sa position par rapport à la fenêtre d'affichage.
FocusElement	UiElement	L'élément d'IU de mise au point.
FocusOffset	Entier	L'index de base 0 du caractère où la sélection de texte s'est terminée (à partir du texte intégral de l'élément cible).
SelectedText	Chaîne de caractères (string)	La nouvelle sélection de texte pour l'élément cible.

DownloadChangedArgs

Renvoie les données des événements suivants : État de téléchargement modifié (Download state changed) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs

Propriété	Saisie de texte	Description
State	Chaîne de caractères (string)	La chaîne décrivant une modification dans un state de downloads.DownloadItem.
Id	Chaîne de caractères (string)	L'id du downloads.DownloadItem qui a été modifié.
FileName	Chaîne de caractères (string)	La chaîne décrivant une modification dans un url de downloads.DownloadItem.
Url	Chaîne de caractères (string)	La chaîne décrivant une modification dans un filename de downloads.DownloadItem.
StartTime	Chaîne de caractères (string)	La chaîne décrivant une modification dans un startTime de downloads.DownloadItem.
EndTime	Chaîne de caractères (string)	La chaîne décrivant une modification dans un endTime de downloads.DownloadItem.
Error	Chaîne de caractères (string)	La chaîne décrivant une modification du statut error de downloads.DownloadItem.

TabActivatedArgs

Renvoie les données des événements suivants : Onglet activé (Tab activated) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabActivatedArgs

Propriété	Saisie de texte	Description
TabId	Chaîne de caractères (string)	L'ID de l'onglet devenu actif.
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre dans laquelle l'onglet sélectionné a été modifié.
Title	Chaîne de caractères (string)	Le nouveau titre de l'onglet.
Url	Chaîne de caractères (string)	L'URL de l'onglet si elle a changé.

TabCreatedArgs

Renvoie les données des événements suivants : Onglet créé (Tab created) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

Propriété	Saisie de texte	Description
TabId	Chaîne de caractères (string)	L'ID de l'onglet qui a été créé.
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre qui contient l'onglet.
Title	Chaîne de caractères (string)	Le nouveau titre de l'onglet.
Url	Chaîne de caractères (string)	L'URL de l'onglet.

TabRemovedArgs

Renvoie les données des événements suivants : Onglet supprimé (Tab removed) (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

Propriété	Saisie de texte	Description
TabId	Chaîne de caractères (string)	L'ID de l'onglet qui a été supprimé.
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre dont l'onglet est fermé.
IsWindowClosing	Booléen	True lorsque l'onglet a été fermé car sa fenêtre parente a été fermée.

TabUpdatedArgs

Renvoie les données des événements suivants : Onglet mis à jour (pour WEBCTRL).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

Propriété	Saisie de texte	Description
TabId	Chaîne de caractères (string)	L'ID de l'onglet qui a été mis à jour.
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre qui contient l'onglet.
Status	Chaîne de caractères (string)	Le statut de chargement de l'onglet.
Title	Chaîne de caractères (string)	Le nouveau titre de l'onglet.
Url	Chaîne de caractères (string)	L'URL de l'onglet si elle a changé.
Active	Booléen	Indique si l'onglet est actif dans sa fenêtre. Cela ne signifie pas nécessairement que la fenêtre est ciblée.

TabNavigationStartedArgs

Renvoie les données des événements démarrés par la navigation d'onglets (pour html).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs

Propriété	Saisie de texte	Description
Url	Chaîne de caractères (string)	L'URL actuellement associée au cadre, si le cadre identifié par le FrameId existait à un moment donné dans l'onglet donné. Le fait qu'une URL soit associée à un FrameId donné n'implique pas que le cadre correspondant existe toujours.
TabId	Entier	L'ID de l'onglet dans lequel se trouve le cadre.
FrameId	Entier	L'ID du cadre dans l'onglet, pour lequel l'événement démarré a été déclenché, résultant en une navigation par onglets. Les cadres sont identifiés de manière unique par leurs TabId et FrameId.
TimeStampMs	Double	La propriété TimeStampMs des événements de la navigation Web est uniquement garantie pour être cohérente en interne . La comparaison d'un événement à un autre événement vous donnera le bon décalage entre eux, mais en les comparant à l'heure actuelle à l'intérieur de l'extension (via (new Date()).getTime(), par exemple) pourrait donner des résultats inattendus.
DateTime	Date	S/O

TabNavigationCompletedArgs

Renvoie les données des événements de navigation par onglets terminés (pour html).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs

Propriété	Saisie de texte	Description
Url	Chaîne de caractères (string)	URL actuellement associée à ce cadre, si le cadre identifié par le FrameId existait à un moment donné dans l'onglet donné. Le fait qu'une URL soit associée à un FrameId donné n'implique pas que le cadre correspondant existe toujours.
TabId	Entier	ID de l'onglet dans lequel se trouve le cadre.
FrameId	Entier	L'ID du cadre dans l'onglet, pour lequel l'événement terminé a été déclenché, résultant en une navigation par onglets. Les cadres sont identifiés de manière unique par leurs TabId et FrameId.
TimeStampMs	Double	La propriété TimeStampMs des événements de la navigation Web est uniquement garantie pour être cohérente en interne . La comparaison d'un événement à un autre événement vous donnera le bon décalage entre eux, mais en les comparant à l'heure actuelle à l'intérieur de l'extension (via (new Date()).getTime(), par exemple) pourrait donner des résultats inattendus.
DateTime	Date	S/O

HtmlWindowFocusChangedArgs

Renvoie les données des événements Changement de focus de fenêtre (pour html).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

Propriété	Saisie de texte	Description
TabId	Chaîne de caractères (string)	L'ID de l'onglet nouvellement activé.
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre qui contient l'onglet.
Title	Chaîne de caractères (string)	Titre de l'onglet.
Url	Chaîne de caractères (string)	L'URL de l'onglet si elle a changé.

HtmlWindowBoundsChangedArgs

Renvoie les données des événements liés aux limites de fenêtre modifiées (pour html).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

Propriété	Saisie de texte	Description
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre dont les limites ont été modifiées.
Focused	Booléen	Indique si la fenêtre est actuellement la fenêtre ciblée.
Top	Entier	Le décalage de la fenêtre par rapport au bord supérieur de l'écran en pixels.
Left	Entier	Le décalage de la fenêtre par rapport au bord gauche de l'écran en pixels.
Width	Entier	La largeur de la fenêtre, qui inclut le cadre, en pixels.
Height	Entier	La hauteur de la fenêtre, qui inclut le cadre, en pixels.

HtmlWindowCreatedArgs

Renvoie les données des événements créés par Window (pour html).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

Propriété	Saisie de texte	Description
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre créée.

HtmlWindowRemovedArgs

Renvoie les données des événements supprimés par Window (pour html).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

Propriété	Saisie de texte	Description
WindowId	Chaîne de caractères (string)	L'ID de la fenêtre supprimée.

UiaToggledArgs

Renvoie les données des événements suivants : Événements activés/désactivés (Toggled events) (pour UIA).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

Propriété	Saisie de texte	Description
State	Chaîne de caractères (string)	Le nouvel état de l'élément cible.

UiaTextSelectionChangedArgs

Renvoie les données des événements Sélection de texte modifiée (Text selection changed) (pour uia).

Héritage : TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

Propriété	Saisie de texte	Description
TextRanges	UiaTextRange()	Tableau qui contient différentes informations sur les éléments de texte sélectionnés dans l'élément cible (nous pouvons avoir plusieurs éléments de texte sélectionnés en cas de sélection de texte non adjacent). Chaque élément de ce tableau affiche les informations suivantes : Text (type String) - Sélection du texte pour cet élément de texte sélectionné. Exemple : TriggerEventArgs.TextRanges(0).Text représente le texte du premier élément de texte sélectionné. BoundingRectangles (type Rectangle()) - Tableau de rectangles englobants pour l'élément de texte sélectionné. Un élément de texte sélectionné peut avoir plusieurs rectangles de délimitation associés s'il s'étend sur plusieurs lignes. Chaque rectangle englobant est de type Rectangle {X, Y, Width, Height} et fournit des informations sur la position et la taille de l'élément. Exemple : TriggerEventArgs.TextRanges(0).BoundingRectangles(0) représente le rectangle englobant de la première ligne dans le premier élément de texte sélectionné.

Outil d'inspection d'événement

Dans le contexte de l'automatisation Attended basée sur un déclencheur, l'outil d'inspection d'événement peut être utilisé pour identifier le type d'événements natifs déclenchés lorsque vous interagissez avec certains éléments d'IU dans une application, puis pour configurer l'activité Déclencheur d'événement d'application (Application Event Trigger). L'outil capture et surveille tous les types d'événements sélectionnés, tels que Clic (Click), Touche enfoncée (Key pressed), Focus atteint (Focus gained), Focus perdu (Focus lost) et autres interactions pertinentes, vous permettant d'analyser les actions effectuées et, le cas échéant, de diagnostiquer les problèmes.

L'outil d'inspection d'événement peut être ouvert à partir de UI Explorer, une fois qu'un élément d'IU valide est sélectionné, en cliquant sur le bouton Inspecter les événements (Inspect Events) de la barre d'outils.

La barre d'outils se compose des options suivantes :

• Enregistrer (Record) : les événements générés par l'interaction avec l'élément d'IU sont enregistrés et ajoutés à la liste des événements.
• Suspendre (Pause) : les événements générés par l'élément d'IU lorsque vous interagissez avec lui ne sont plus enregistrés.
• Surbrillance (Highlight) : affiche le contour de l'élément cible et le met au premier plan pendant quelques secondes. Il reste surligné jusqu'à ce qu'il soit désactivé.
• Ouvrir dans UI Explorer (Open in UI Explorer) : l'élément surveillé est ouvert dans UI Explorer, d'où vous pouvez observer le sélecteur de cet élément.

Une fois que vous avez démarré l'enregistrement de l'événement, deux autres options deviennent disponibles :

• Effacer (Clear) : supprime tous les événements enregistrés.
• CSV : les événements capturés peuvent être exportés vers un fichier .csv pour une analyse plus approfondie.

La fenêtre de l'outil d'inspection d'événement comporte deux sections principales :

• Filtre d'événements (Event filter) : permet de sélectionner les types d'événements que vous souhaitez surveiller pour l'élément cible.
• Liste des événements (Event list) : affiche des informations sur les événements capturés.

Vous pouvez filtrer les types d'événement à capturer en activant ou cochant ou décochant les cases dans la liste des types d'événement. La liste peut varier en fonction de la technologie d'élément sélectionnée.

Tous les types d'événements de souris (Souris déplacée (Mouse Move), Souris enfoncée (Mouse pressed), Souris relâchée (Mouse released), Souris entrée (Mouse entered), Souris sortie (Mouse exited)), spécifiques aux éléments d'IU Web ou Java, sont désactivés par défaut car la liste d'événements, dans de tels cas, peut devenir assez volumineuse. Nous vous recommandons de n'activer les types d'événements de souris que si vous avez un besoin spécifique de les surveiller.

Il convient également de mentionner que les types d'événements peuvent être activés ou désactivés même après avoir commencé l'enregistrement de l'événement.

La liste des événements comporte trois colonnes :

• Nom de l'événement (Event Name) : le type d'événement.
• Horodatage (Time Stamp) : la date et l'heure auxquelles l'événement a eu lieu.
• Données de l'événement (Event Data) : les données et paramètres associés à un événement donné.

Chaque colonne peut être triée par ordre croissant ou décroissant. Les événements s'affichent par défaut dans l'ordre dans lequel ils ont eu lieu.

Lorsque le type d'événement Disparu (Disappeared) est trouvé, vous ne pouvez plus continuer la surveillance et un message d'erreur s'affiche à l'écran. Lorsque vous cliquez sur une option de la barre d'outils, le même message d'erreur s'affiche à l'écran. Les seules options disponibles consistent à effacer les données ou à les exporter vers un fichier .csv. Pour reprendre la surveillance, fermez la fenêtre et ouvrez une autre instance de l'outil d'inspection d'événement.