AutomationElement.FromPoint(Point) Método

Definição

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Recupera um novo AutomationElement objeto para o item de interface do usuário (interface do usuário) no ponto especificado na área de trabalho.

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

Parâmetros

pt

Point

As coordenadas de tela física na área de trabalho na qual localizar o elemento de interface do usuário.

Retornos

AutomationElement

O item de interface do usuário no ponto especificado.

Exemplos

O exemplo a seguir recupera o AutomationElement no local do cursor do sistema.

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

Comentários

FromPoint retorna o elemento na árvore lógica mais próxima do elemento raiz.

Se o aplicativo cliente tentar encontrar elementos em sua própria interface do usuário, você deverá fazer todas as chamadas Automação da Interface do Usuário em um thread separado.

Embora o ponto esteja dentro do retângulo delimitador do retornado AutomationElement, ele não está necessariamente em uma parte clicável do controle. Por exemplo, um botão redondo pode não ser clicável perto de um dos cantos de seu retângulo delimitador.

Confira também

• FromHandle(IntPtr)
• Obtendo elementos da automação interface do usuário
• Automação da Interface do Usuário e Escala da Tela
• Problemas de Threading na Automação da Interface do Usuário