Cliquer sur le texte (Click Text)

UiPath.Core.Activities.ClickText

Recherche une chaîne donnée dans un élément de l'interface utilisateur indiqué et clique dessus.

Important :

L’activité Double Click Text a la même fonctionnalité que l’activité Click Text , la seule différence est que pour l’activité Double Click Text , le ClickType est défini par défaut sur CLICK_DOUBLE, tandis que pour l’activité Click Text , le ClickType est défini par défaut sur CLICK_SINGLE.

Avertissement : cette activité ne fonctionne pas correctement lorsqu'elle est utilisée dans des navigateurs qui nécessitent l'automatisation des extensions, tels que Chrome, Firefoxet Edge.

Propriétés

Commun

• ContinuerSurErreur (ContinueOnError) - spécifie si l’automatisation doit se poursuivre même lorsque l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False)). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreurs.
  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera 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 souris (simple, double, haut, bas) utilisé lors de la simulation de l'événement de clic. Par défaut, un seul clic est sélectionné.
• 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é.
• Occurrence (Occurrence) - Si la chaîne du champ Text apparaît plusieurs fois dans l'élément de l'interface utilisateur indiqué, spécifiez ici le nombre d'occurrences sur lesquelles vous souhaitez cliquer. Par exemple si la chaîne apparaît 4 fois et que vous voulez cliquer sur la première occurrence, écrivez 1 dans ce champ. La valeur par défaut est 1.
• 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.
• Délai d'attente (millisecondes) : indique le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur SelectorNotFoundException soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes).
• Cible.AttendrePrêt : avant d’effectuer les actions, la propriété attend que la cible soit prête. Par défaut, Interactive/Complete est sélectionné. Les options suivantes sont disponibles :
  • 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.
• Texte (Text) - Chaîne sur laquelle il faut cliquer. Toutes les chaînes doivent être placées entre guillemets.

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 ducurseur.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 Centre(Center).
• Texte formaté (FormattedText) - Lorsque cette case est cochée, la mise en page de l'écran du texte sélectionné est préservée.

• Les options suivantes sont disponibles : Aucun, Alt, Ctrl, Shift, Win. L'option par défaut est Aucun.

  Remarque : KeyModifiers ne peut pas être utilisé avec l’option SendWindowMessages . 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 de saisie est plus rapide et fonctionne en arrière-plan. Par défaut, cette case à cocher n'est pas sélectionnée. Si cette case à cocher n'est pas sélectionnée, la méthode par défaut exécute le clic en utilisant le pilote matériel. La méthode par défaut est plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.