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

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

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

ITextProvider

ITextRangeProvider

Referência

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