AutomationElement.GetClickablePoint Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Automation
Assembly:
UIAutomationClient.dll

Récupère un point du AutomationElement sur lequel l'utilisateur peut cliquer.

public:
 System::Windows::Point GetClickablePoint();
public System.Windows.Point GetClickablePoint ();
member this.GetClickablePoint : unit -> System.Windows.Point
Public Function GetClickablePoint () As Point

Retours

Point

Coordonnées d'écran physiques d'un point qui peut être utilisé par un client pour cliquer sur cet élément.

Exceptions

NoClickablePointException

Il n’existe pas de point où cliquer.

ElementNotAvailableException

L’interface utilisateur pour AutomationElement n’existe plus.

Exemples

Le code suivant récupère un point clickable pour un contrôle et déplace le curseur système vers ce point.

// element is an AutomationElement.
System.Windows.Point clickablePoint = element.GetClickablePoint();
System.Windows.Forms.Cursor.Position = 
    new System.Drawing.Point((int)clickablePoint.X, (int)clickablePoint.Y);

' element is an AutomationElement.
Dim clickablePoint As System.Windows.Point = element.GetClickablePoint()
System.Windows.Forms.Cursor.Position = New System.Drawing.Point(CInt(clickablePoint.X), CInt(clickablePoint.Y))

Remarques

Un AutomationElement n’est pas clickable s’il est complètement masqué par une autre fenêtre.

Un AutomationElement clic peut être fait lorsqu’il répond à toutes les conditions suivantes :

  • Il est visible par programmation et disponible avec l’arborescence UI Automation.

  • Il est fait défiler entièrement en mode dans son conteneur parent, le cas échéant. Si l’élément est clippé, il n’y a aucune garantie qu’il est clickable.

  • L’élément n’est masqué par aucun autre élément d’interface utilisateur. Si l’élément est partiellement masqué par un élément d’interface utilisateur autre que ses ancêtres, il peut ne pas être clickable.

  • La fenêtre contenant l’élément doit elle-même être clickable. Par exemple, la fenêtre n’est pas clickable si la fenêtre contenant est complètement transparente. Les clics de souris cliquent sur la fenêtre sous la fenêtre, de sorte que les contrôles de la fenêtre transparente ne retournent pas de points clickables.

  • Si l’élément est un conteneur (tel que la liste ou l’arborescence), il doit avoir un point qui, lorsqu’il est cliqué, entraîne le focus de l’arrière-plan du contrôle. Si chaque partie du contrôle conteneur est occupée par un élément enfant, elle n’est pas clickable.

Il n’existe aucune garantie qu’un contrôle fasse quoi que ce soit lorsqu’il clique sur un point défini comme pouvant être cliqué par le fournisseur UI Automation. Envisagez d’utiliser des modèles de contrôle à la place pour effectuer des actions sur les contrôles.

S’applique à

Voir aussi