AutomationElement.GetClickablePoint Método

public:
 System::Windows::Point GetClickablePoint();

public System.Windows.Point GetClickablePoint();

member this.GetClickablePoint : unit -> System.Windows.Point

Public Function GetClickablePoint () As Point

Retornos

As coordenadas de tela física de um ponto que pode ser usado por um cliente para clicar nesse elemento.

Exceções

Exemplos

O código a seguir recupera um ponto clicável para um controle e move o cursor do sistema para esse ponto.

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

Comentários

Um AutomationElement não é clicável se for completamente obscurecido por outra janela.

Um AutomationElement clicável é clicável quando atende a todas as seguintes condições:

• Ele está visível programaticamente e disponível com a árvore de Automação da Interface do Usuário.

• Ele é rolado totalmente para exibição dentro de seu contêiner pai, se houver. Se o elemento for recortado, não haverá garantia de que ele seja clicável.

• O elemento não é obscurecido por nenhum outro elemento de interface do usuário. Se o elemento for parcialmente obscurecido por algum elemento de interface do usuário que não seja seus ancestrais, ele poderá não ser clicável.

• A janela que contém o elemento deve ser clicável. Por exemplo, a janela não poderá ser clicada se a janela de contenção for completamente transparente. Os cliques do mouse clicarão na janela abaixo, para que todos os controles dentro da janela transparente não retornem pontos clicáveis.

• Se o elemento for um contêiner (como lista ou exibição de árvore), ele deverá ter um ponto em que, quando clicado, fará com que a tela de fundo do controle seja focada. Se cada parte do controle de contêiner for ocupada por um elemento filho, ele não poderá ser clicado.

Não há nenhuma garantia de que um controle fará qualquer coisa quando clicado em um ponto definido como clicável pelo provedor de Automação da Interface do Usuário. Considere usar padrões de controle para executar ações em controles.

Confira também

• TryGetClickablePoint(Point)
• Automação da Interface do Usuário e Dimensionamento de Tela