AutomationElement.FromPoint(Point) AutomationElement.FromPoint(Point) AutomationElement.FromPoint(Point) AutomationElement.FromPoint(Point) Method

Definition

Ruft ein neues AutomationElement-Objekt für das Benutzeroberfläche (User Interface, UI)user interface (UI)-Element am angegebenen Punkt auf dem Desktop ab.Retrieves a new AutomationElement object for the Benutzeroberfläche (User Interface, UI)user interface (UI) item at specified point on the desktop.

public:
 static System::Windows::Automation::AutomationElement ^ FromPoint(System::Windows::Point pt);
public static System.Windows.Automation.AutomationElement FromPoint (System.Windows.Point pt);
static member FromPoint : System.Windows.Point -> System.Windows.Automation.AutomationElement
Public Shared Function FromPoint (pt As Point) As AutomationElement

Parameter

pt
Point Point Point Point

Die physischen Bildschirmkoordinaten auf dem Desktop für die Position des UIUI-Elements.The physical screen coordinates on the desktop at which to locate the UIUI element.

Gibt zurück

Das UIUI-Element am angegebenen Punkt.The UIUI item at the specified point.

Beispiele

Im folgenden Beispiel wird das AutomationElement an der Cursorposition des Systems abgerufen.The following example retrieves the AutomationElement at the system cursor location.

private AutomationElement ElementFromCursor()
{
    // Convert mouse position from System.Drawing.Point to System.Windows.Point.
    System.Windows.Point point = new System.Windows.Point(Cursor.Position.X, Cursor.Position.Y);
    AutomationElement element = AutomationElement.FromPoint(point);
    return element;
}
Private Function ElementFromCursor() As AutomationElement
    ' Convert mouse position from System.Drawing.Point to System.Windows.Point.
    Dim cursorPoint As System.Windows.Point = New System.Windows.Point( _
        System.Windows.Forms.Cursor.Position.X, System.Windows.Forms.Cursor.Position.Y)
    Return AutomationElement.FromPoint(cursorPoint)
End Function

Hinweise

FromPointGibt das Element in der logischen Struktur zurück, das dem Stamm Element am nächsten ist.FromPoint returns the element in the logical tree that is closest to the root element.

Wenn Ihre Client Anwendung möglicherweise versucht, Elemente in ihrer eigenen Benutzeroberfläche zu finden, müssen Sie BenutzeroberflächenautomatisierungUI Automation alle Aufrufe in einem separaten Thread durchführen.If your client application might try to find elements in its own user interface, you must make all BenutzeroberflächenautomatisierungUI Automation calls on a separate thread.

Obwohl sich der Punkt innerhalb des umgebenden Rechtecks des zurück AutomationElementgegebenen befindet, ist es nicht notwendigerweise auf einem klickbaren Teil des Steuer Elements.Although the point is within the bounding rectangle of the returned AutomationElement, it is not necessarily on a clickable part of the control. Beispielsweise kann eine roundschaltfläche nicht in der Nähe eines der Ecken des umgebenden Rechtecks angezeigt werden.For example, a round button might not be clickable near one of the corners of its bounding rectangle.

Gilt für:

Siehe auch