AutomationElement.GetClickablePoint AutomationElement.GetClickablePoint AutomationElement.GetClickablePoint AutomationElement.GetClickablePoint Method

Definition

Ruft einen Punkt im AutomationElement ab, auf den geklickt werden kann.Retrieves a point on the AutomationElement that can be clicked.

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

Die physischen Bildschirmkoordinaten eines Punkts, den ein Client zum Klicken auf dieses Element verwenden kann.The physical screen coordinates of a point that can be used by a client to click on this element.

Ausnahmen

Es gibt keinen Punkt, auf den geklickt werden kann.There is no clickable point.

Die Benutzeroberfläche für das AutomationElement ist nicht mehr vorhanden.The UI for the AutomationElement no longer exists.

Beispiele

Der folgende Code Ruft einen durch Klicken aktivierbaren Punkt für ein Steuerelement, und verschiebt den Systemcursor bis zu diesem Zeitpunkt.The following code retrieves a clickable point for a control and moves the system cursor to that 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))

Hinweise

Ein AutomationElement ist nicht klickbar, wenn es vollständig von einem anderen Fenster verdeckt wird.An AutomationElement is not clickable if it is completely obscured by another window.

Ein AutomationElement ist geklickt werden kann, wenn sie alle folgenden Bedingungen erfüllt:An AutomationElement is clickable when it satisfies all the following conditions:

  • Kann programmgesteuert sichtbar und verfügbar, mit der BenutzeroberflächenautomatisierungUI Automation Struktur.It is programmatically visible and available with the BenutzeroberflächenautomatisierungUI Automation tree.

  • Es vollständig in die Ansicht im übergeordneten Container, ggf. ein Bildlauf durchgeführt wird.It is scrolled fully into view within its parent container, if any. Wenn das Element abgeschnitten wird, besteht keine Garantie, dass es durch Klicken aktivierbaren ist.If the element is clipped, there is no guarantee that it is clickable.

  • Das Element verdeckt wird nicht durch andere Elemente der Benutzeroberfläche.The element is not obscured by any other UI element. Wenn das Element durch ein UI-Element als Vorgänger teilweise verdeckt wird, kann es nicht klickbar sein.If the element is partially obscured by some UI element other than its ancestors, it might not be clickable.

  • Das Fenster, welches das Element enthält, muss selbst durch Klicken aktivierbaren sein.The window containing the element must itself be clickable. Das Fenster ist z. B. nicht geklickt werden kann, wenn enthaltenden Fensters vollständig transparent ist.For example, the window is not clickable if the containing window is completely transparent. Mausklicks werden an das Fenster darunter, durch Klicken, sodass alle Steuerelemente im Fenster transparent durch Klicken aktivierbaren Punkte nicht zurückgegeben werden.Mouse clicks will click through to the window underneath, so any controls within the transparent window will not return clickable points.

  • Wenn das Element ein Container (z. B. die Liste oder einer Strukturansicht anzeigen) ist, muss einen Punkt, dass beim Klicken wird dazu führen, dass der Hintergrund des Steuerelements den Fokus erhält.If the element is a container (such as list or tree view), it must have a point that when clicked will cause the background of the control to be focused. Wenn von einem untergeordneten Element jeder Teil des Containersteuerelements eingenommen wird, ist es nicht geklickt werden kann.If every part of the container control is occupied by a child element, it is not clickable.

Es gibt keine Garantie, die ein Steuerelement beim Klicken auf einen definierten Punkt nichts wird von der Benutzeroberflächenautomatisierungs-Anbieter wie geklickt werden kann.There is no guarantee that a control will do anything when clicked on a point defined as clickable by the UI Automation provider. Erwägen Sie stattdessen Steuerelementmuster für Aktionen auf Steuerelemente zu verwenden.Consider using control patterns instead to perform actions on controls.

Gilt für:

Siehe auch