AutomationElement.GetClickablePoint Methode

  • Referenz

Definition

Namespace:
System.Windows.Automation
Assembly:
UIAutomationClient.dll

Ruft einen Punkt im AutomationElement ab, auf den geklickt werden kann.

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

Gibt zurück

Point

Die physischen Bildschirmkoordinaten eines Punkts, den ein Client zum Klicken auf dieses Element verwenden kann.

Ausnahmen

NoClickablePointException

Es gibt keinen Punkt, auf den geklickt werden kann.

ElementNotAvailableException

Die Benutzeroberfläche für das AutomationElement ist nicht mehr vorhanden.

Beispiele

Der folgende Code ruft einen klickbaren Punkt für ein Steuerelement ab und verschiebt den Systemcursor zu diesem Punkt.

// 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))

Hinweise

Es AutomationElement kann nicht geklickt werden, wenn es vollständig von einem anderen Fenster verdeckt ist.

Ein AutomationElement Klickbar, wenn er alle folgenden Bedingungen erfüllt:

  • Es ist programmgesteuert sichtbar und mit der Benutzeroberflächenautomatisierung Struktur verfügbar.

  • Es wird vollständig in die Ansicht innerhalb des übergeordneten Containers verschoben, falls vorhanden. Wenn das Element geclippt ist, gibt es keine Garantie, dass es klickbar ist.

  • Das Element wird nicht von einem anderen UI-Element verdeckt. Wenn das Element teilweise von einem anderen UI-Element als seinen Vorgängern verdeckt wird, kann es möglicherweise nicht geklickt werden.

  • Das Fenster mit dem Element muss selbst geklickt werden. Das Fenster kann z. B. nicht geklickt werden, wenn das enthaltende Fenster vollständig transparent ist. Mausklicks klicken auf das Fenster unterhalb, sodass alle Steuerelemente im transparenten Fenster keine klickbaren Punkte zurückgeben.

  • Wenn das Element ein Container (z. B. Listen- oder Strukturansicht) ist, muss er einen Punkt aufweisen, der beim Klicken den Hintergrund des Steuerelements zum Fokus führt. Wenn jeder Teil des Containersteuerelements von einem untergeordneten Element besetzt ist, ist es nicht auf klickbar.

Es gibt keine Garantie, dass ein Steuerelement etwas tun wird, wenn er auf einen Punkt klickt, der durch den Benutzeroberflächenautomatisierung Anbieter geklickt wird. Ziehen Sie stattdessen die Verwendung von Steuerelementmustern in Betracht, um Aktionen für Steuerelemente auszuführen.

Gilt für

Siehe auch