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

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

Confira também

IUIAutomationTextPattern

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