AutomationElement.GetClickablePoint Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.PointPublic Function GetClickablePoint () As PointDevoluções
As coordenadas físicas do ecrã de um ponto que podem ser usadas por um cliente para clicar neste elemento.
Exceções
Não existe um ponto clicável.
A interface para a AutomationElement interface já não existe.
Exemplos
O código seguinte recupera um ponto clicável para um controlo 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))
Observações
An AutomationElement não é clicável se estiver completamente oculto por outra janela.
Um AutomationElement é clicável quando satisfaz todas as seguintes condições:
É visível programaticamente e está disponível com a árvore Automatização da Interface de Utilizador.
Está completamente deslocado para a vista dentro do seu contentor principal, se existir. Se o elemento for cortado, não há garantia de que seja clicável.
O elemento não é obscurecido por nenhum outro elemento da interface. Se o elemento estiver parcialmente obscurecido por algum elemento da interface que não seja os seus antecessores, pode não ser clicável.
A janela que contém o elemento deve ser ela própria clicável. Por exemplo, a janela não é clicável se a janela contenda for completamente transparente. Os cliques do rato vão clicar até à janela por baixo, por isso quaisquer controlos dentro da janela transparente não devolvem pontos clicáveis.
Se o elemento for um contentor (como uma vista de lista ou de árvore), deve ter um ponto que, ao ser clicado, fará com que o fundo do controlo fique focado. Se todas as partes do controlo do contentor estiverem ocupadas por um elemento filho, não é clicável.
Não há garantia de que um controlo faça algo quando clicado num ponto definido como clicável pelo fornecedor de Automatização da Interface de Utilizador. Considere usar padrões de controlo para executar ações sobre controlos.