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 kannThe 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 kannThere 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 ab und verschiebt den System Cursor zu diesem Punkt.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 von einem anderen Fenster vollständig verdeckt wird.An AutomationElement is not clickable if it is completely obscured by another window.

Ein AutomationElement -Element kann durch Klicken angezeigt werden, wenn es alle folgenden Bedingungen erfüllt:An AutomationElement is clickable when it satisfies all the following conditions:

  • Sie ist Programm gesteuert sichtbar und in der BenutzeroberflächenautomatisierungUI Automation -Struktur verfügbar.It is programmatically visible and available with the BenutzeroberflächenautomatisierungUI Automation tree.

  • Der scrollup wird in seinem übergeordneten Container vollständig angezeigt, falls vorhanden.It is scrolled fully into view within its parent container, if any. Wenn das Element abgeschnitten wird, gibt es keine Garantie dafür, dass es klickbar ist.If the element is clipped, there is no guarantee that it is clickable.

  • Das-Element wird von keinem anderen Benutzeroberflächen Element verdeckt.The element is not obscured by any other UI element. Wenn das Element teilweise von einem anderen Benutzeroberflächen Element als seinen übergeordneten Elementen verdeckt wird, ist es möglicherweise nicht klickbar.If the element is partially obscured by some UI element other than its ancestors, it might not be clickable.

  • Das Fenster, das das Element enthält, muss selbst klickbar sein.The window containing the element must itself be clickable. Beispielsweise kann das Fenster nicht geklickt werden, wenn das enthaltende Fenster vollständig transparent ist.For example, the window is not clickable if the containing window is completely transparent. Mausklicks durch Klicken auf das Fenster unterhalb, sodass alle Steuerelemente im transparenten Fenster keine durch Klicken aktivierbaren Punkte zurückgeben.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 ist (z. b. Listen-oder Strukturansicht), muss es über einen Punkt verfügen, der den Hintergrund des Steuer Elements im Fokus hat, wenn er darauf geklickt wird.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 jeder Teil des Container Steuer Elements von einem untergeordneten Element belegt wird, kann er nicht klickbar sein.If every part of the container control is occupied by a child element, it is not clickable.

Es gibt keine Garantie dafür, dass ein Steuerelement etwas durchführt, wenn auf einen Punkt geklickt wird, der vom Benutzeroberflächenautomatisierungs-Anbieter als Klick fähig definiert wurdeThere is no guarantee that a control will do anything when clicked on a point defined as clickable by the UI Automation provider. Verwenden Sie stattdessen Steuerelement Muster, um Aktionen für Steuerelemente auszuführen.Consider using control patterns instead to perform actions on controls.

Gilt für:

Siehe auch