Compartilhar via


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

Recupera uma matriz de intervalos de texto desarticulados 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] IUIAutomationTextRangeArray **ranges
);

Parâmetros

[out, retval] ranges

Tipo: IUIAutomationTextRangeArray**

Recebe um ponteiro para a coleção de intervalos de texto visíveis dentro do controle baseado em texto.

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

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

Se o texto visível consistir em vários intervalos de texto desarticulados, a matriz de intervalos 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 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 do modo de exibição.

IUIAutomationTextPattern::GetVisibleRanges recupera 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

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 (inclua UIAutomation.h)

Confira também

IUIAutomationTextPattern

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