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
| 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
Práticas recomendadas para usar matrizes seguras
Conceitual
Referência
Visão Geral dos Provedores de Automação de Interface do Usuário