Compartilhar via


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

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)

Confira também

Conceitual

ITextProvider

ITextRangeProvider

Referência

Visão Geral dos Provedores de Automação de Interface do Usuário