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

  • Artigo

Recupera uma coleção de intervalos de texto que representa o texto selecionado no momento em um controle baseado em texto.

Sintaxe

HRESULT GetSelection(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

Parâmetros

[out, retval] ranges

Tipo: IUIAutomationTextRangeArray**

Recebe um ponteiro para a coleção de intervalos de 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 controle der suporte à seleção de vários intervalos não contíguos de texto, a coleção de intervalos receberá um intervalo de texto para cada intervalo selecionado.

Se o controle contiver apenas um único intervalo de texto selecionado, a coleção de intervalos receberá um único intervalo de texto.

Se o controle contiver um ponto de inserção de texto, mas nenhum texto for selecionado, a coleção de intervalos receberá um intervalo de texto degenerado (vazio) na posição do ponto de inserção de texto.

Se o controle não contiver um ponto de inserção de texto ou não der suporte à seleção de texto, os intervalos serão definidos como NULL.

Use a propriedade IUIAutomationTextPattern::SupportedTextSelection para testar se um controle dá suporte à seleção de 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 (include UIAutomation.h)

Confira também

IUIAutomationTextPattern

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