AutomationElement.GetClickablePoint Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Récupère un point sur celui AutomationElement qui peut être cliqué.
public:
System::Windows::Point GetClickablePoint();public System.Windows.Point GetClickablePoint();member this.GetClickablePoint : unit -> System.Windows.PointPublic Function GetClickablePoint () As PointRetours
Coordonnées de l’écran physique d’un point qui peut être utilisé par un client pour cliquer sur cet élément.
Exceptions
Il n’y a aucun point cliquable.
L’interface utilisateur de l’interface utilisateur n’existe AutomationElement plus.
Exemples
Le code suivant récupère un point cliquable 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 élément n’est pas cliquable s’il est complètement masqué par une autre fenêtre.
Un AutomationElement clic peut être fait lorsqu’il satisfait à toutes les conditions suivantes :
Il est visible par programmation et disponible avec l’arborescence UI Automation.
Il fait défiler entièrement la vue dans son conteneur parent, le cas échéant. Si l’élément est clippé, il n’existe aucune garantie qu’il est cliquable.
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 cliquable.
La fenêtre contenant l’élément doit elle-même être cliquable. Par exemple, la fenêtre n’est pas cliquable si la fenêtre contenante 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 cliquables.
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, il n’est pas cliquable.
Il n’existe aucune garantie qu’un contrôle fera quoi que ce soit en cliquant sur un point défini comme pouvant être cliqué par le fournisseur de UI Automation. Envisagez plutôt d’utiliser des modèles de contrôle pour effectuer des actions sur des contrôles.
