Método ITextProvider::RangeFromPoint (uiautomationcore.h)

Artigo
03/03/2024

Retorna o intervalo de texto (vazio) de degeneração mais próximo das coordenadas da tela especificadas.

Sintaxe

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Parâmetros

[in] point

Tipo: UiaPoint

O local em coordenadas da tela.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Recebe um ponteiro para o intervalo de texto degenerado (vazio) mais próximo do local especificado. Este parâmetro é passado não inicializado.

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 inclui um objeto filho será retornado se as coordenadas da tela estiverem dentro das coordenadas de uma imagem, hiperlink ou outro objeto inserido.

Como o texto oculto não é ignorado por ITextProvider::RangeFromPoint, um intervalo degenerado do texto visível mais próximo ao ponto especificado é retornado.

A propriedade nunca retorna NULL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcore.h (include UIAutomation.h)