Compartilhar via


Método IUIAutomationTextPattern::RangeFromPoint (uiautomationclient.h)

Recupera o intervalo de texto degenerado (vazio) mais próximo das coordenadas de tela especificadas.

Sintaxe

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

Parâmetros

[in] pt

Tipo: POINT

Uma estrutura que contém o local, em coordenadas de tela.

[out, retval] range

Tipo: IUIAutomationTextRange**

Recebe um ponteiro para o intervalo de texto degenerado mais próximo do local especificado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Um intervalo de texto que encapsula um objeto filho será retornado se as coordenadas da tela estiverem dentro das coordenadas de uma imagem, hiperlink, planilha do Microsoft Excel ou outro objeto inserido.

Como o texto oculto não é ignorado, esse método recupera um intervalo degenerado do texto visível mais próximo das coordenadas especificadas.

A implementação de RangeFromPoint no Windows Internet Explorer 9 não retorna o resultado esperado. Em vez disso, os clientes devem:

  1. Chame o método GetVisibleRanges para recuperar uma matriz de intervalos de texto visíveis.
  2. Para cada intervalo de texto na matriz, chame IUIAutomationTextRange::GetBoundingRectangles para recuperar os retângulos delimitadores.
  3. Verifique os retângulos delimitador para localizar o intervalo de texto que ocupa as coordenadas de tela específicas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (include UIAutomation.h)

Confira também

IUIAutomationTextPattern

suporte Automação da Interface do Usuário para conteúdo textual