AutomationElement.GetClickablePoint Método

  • Referência

Definição

Namespace:
System.Windows.Automation
Assembly:
UIAutomationClient.dll

Recupera um ponto no AutomationElement que pode ser clicado.

public:
 System::Windows::Point GetClickablePoint();
public System.Windows.Point GetClickablePoint ();
member this.GetClickablePoint : unit -> System.Windows.Point
Public Function GetClickablePoint () As Point

Retornos

Point

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

Exceções

NoClickablePointException

Não há nenhum ponto clicável.

ElementNotAvailableException

A interface do usuário do AutomationElement não existe mais.

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 pode ser clicado se estiver completamente obscurecido por outra janela.

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

  • Ele está visível programaticamente e disponível com a árvore 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 da 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 que contém 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 que, quando clicado, fará com que o plano de fundo do controle seja focado. Se cada parte do controle de contêiner for ocupada por um elemento filho, ela não poderá ser clicada.

Não há garantia de que um controle fará nada 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.

Aplica-se a

Confira também