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

Artigo
08/26/2023

Recupera uma matriz de intervalos de texto não contíguos de um controle baseado em texto em que cada intervalo de texto representa um intervalo contíguo de texto visível.

Sintaxe

HRESULT GetVisibleRanges(
  [out, retval] SAFEARRAY **pRetVal
);

Parâmetros

[out, retval] pRetVal

Tipo: SAFEARRAY**

Recebe o endereço de uma matriz de ponteiros para as interfaces ITextRangeProvider dos intervalos de texto visíveis ou uma matriz vazia. Uma referência NULL nunca é retornada. Este parâmetro é passado não inicializado.

Valor retornado

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

Se o texto visível consistir em um intervalo contíguo de texto, a matriz pRetVal deverá conter um único intervalo de texto que represente todo o texto visível.

Se o texto visível consistir em vários intervalos de texto não contíguos, a matriz pRetVal deverá conter um intervalo de texto para cada intervalo visível, começando com o primeiro intervalo visível e terminando com o último intervalo visível. Intervalos não contíguos de texto visível podem ocorrer quando o conteúdo de um controle baseado em texto é parcialmente obscurecido por uma janela sobreposta ou outro objeto, ou quando um controle baseado em texto com várias páginas ou colunas tem conteúdo parcialmente rolado para fora da exibição.

ITextProvider::GetVisibleRanges deve retornar um intervalo de texto degenerado (vazio) se nenhum texto estiver visível, se todo o texto for rolado para fora da exibição ou se o controle baseado em texto não contiver texto.

Requisitos


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)