Cliquer sur l'image (Click Image)

UiPath.Core.Activities.ClickImage

Recherche une image dans un élément de l'interface utilisateur et clique dessus.

Important :

L'activité Double-cliquer sur l'image possède les mêmes fonctionnalités que l'activité Cliquer sur l'image , la seule différence est que pour l'activité Double-cliquer sur l'image , le TypeClic est défini par défaut sur CLICK\_DDP, tandis que pour l'activité Cliquer sur l'image , le TypeClic est défini par par défaut sur CLICK\_SINGLE.

Propriétés

Commun

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• Retard après (DelayAfter) - Durée (en millisecondes) s'écoulant après l'exécution de l'activité. Le délai par défaut est de 300 milisecondes.

• Retard avant (DelayBefore) - Délai (en millisecondes) avant que l'activité ne commence à effectuer des opérations. La durée par défaut est de 200 millisecondes.

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Type de clic (ClickType) - Spécifie le type de clic de la souris (clic simple, double-clic, défilement vers le haut, vers le bas) utilisé lors de la simulation de l'événement de clic.
• Précision.Image (Image.Accuracy) - Unité de mesure comprise entre 0 et 1 qui exprime la similarité minimale entre l'image que vous recherchez et celle à trouver. Pratique dans les cas où l'image à trouver est légèrement différente de celle que vous recherchez. La valeur par défaut est 0,8.
• Image.Image (Image.Image) - Image existante à rechercher. Ce champ prend en charge les variables Image uniquement.
• Profil.Image : permet de modifier l'algorithme de détection d'image que vous souhaitez utiliser. L'algorithme Basique est l'algorithme classique, qui a une vitesse moyenne et un coût moyen en ressources. L'algorithme Amélioré peut offrir des résultats plus précis, au détriment de plus de ressources. Par défaut, ce champ est défini sur Basique.
• Bouton de souris (MouseButton) - Bouton de la souris (gauche, droite, milieu) utilisé pour l'action de clic. Par défaut, le bouton gauche de la souris est sélectionné.
• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à l'objet UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.
• Élément cible (Target.Element) - Utiliser la variable UiElement renvoyée par une autre activité. Cette propriété ne peut pas être utilisée avec la propriété Selector. Ce champ prend en charge les variables UiElement uniquement.
• Sélecteur de cible (Target.Selector) - Propriété de texte utilisée pour trouver un élément donné de l'interface utilisateur lors de l'exécution de l'activité. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément d'interface graphique utilisateur que vous recherchez et de certains de ses parents.
• Target.Timeout (milliseconds) : spécifie le délai d'attente (en millisecondes) pour l'exécution de l'activité avant que l'erreur SelectorNotFoundException soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes).
• Target.WaitForReady - Before performing the actions, wait for the target to become ready. By default, Interactive/Complete is selected. The following options are available:
  • None (Aucun) - Attend uniquement la création de l'élément de l'interface utilisateur cible avant d'exécuter l'action. Vous pouvez, par exemple, utiliser cette option si vous souhaitez récupérer uniquement du texte à partir d'une page Web ou cliquer sur un bouton spécifique sans être obligé d'attendre que tous les éléments de l'interface utilisateur soient chargés. Il est à noter que ceci peut avoir des conséquences indésirables si le bouton est basé sur des éléments qui ne sont pas encore chargés, comme par exemple des scripts.
  • Interactif : attend qu'une partie de l'application soit prête.
  • Complète  : attend que l'application entière soit prête.

Divers

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

Options

• Position du curseur X (CursorPosition.OffsetX) - Déplacement horizontal de la position du curseur en fonction de l'option sélectionnée dans le champ Position.

• Position du curseur Y (CursorPosition.OffsetY) - Déplacement vertical de la position du curseur en fonction de l'option sélectionnée dans le champ Position.

• Position X du curseur (CursorPosition.Position) - Décrit le point de départ du curseur auquel les décalages des propriétés OffsetX et OffsetY sont ajoutés. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRight et Center. L'option par défaut est Center.

• ModificateursTouche : vous permet d'ajouter un modificateur de touche. Les options suivantes sont disponibles : Aucun, Alt, Ctrl, Maj, Win. L'option par défaut est None.

  Remarque :

  ModificateursClés ne peut pas être utilisé avec l’option EnvoyerMessagesFenêtre . Aucune erreur n'est générée lors de l'exécution d'un workflow qui contient une activité avec cette combinaison d'options.

• Envoyer des messages (SendWindowMessages) - Si cette option est sélectionnée, le clic est exécuté en envoyant un message spécifique à l'application cible. Cette méthode d'entrée est plus rapide et fonctionne en arrière-plan. Par défaut, cette case à cocher n'est pas sélectionnée. Si cette case n'est pas cochée, la méthode par défaut exécute le clic en utilisant le pilote matériel. La méthode par défaut est la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

Exemple d'utilisation des activités Cliquer sur l'image (Click Image) et Double cliquer sur l'image (Double Click Image)

Vous pouvez voir comment les activités Cliquer sur l'image et Double-cliquer sur l'image sont utilisées dans un exemple qui intègre plusieurs activités.

Vous pouvez consulter et télécharger l'exemple ici.