Compartilhar via

Método IUIAutomationTextPattern2::GetCaretRange (uiautomationclient.h)

  • Artigo

Recupera um intervalo de texto de comprimento zero no local do cursor que pertence ao controle baseado em texto.

Sintaxe

HRESULT GetCaretRange(
  [out, retval] BOOL                   *isActive,
  [out, retval] IUIAutomationTextRange **range
);

Parâmetros

[out, retval] isActive

Tipo: BOOL*

TRUE se o controle baseado em texto que contém o cursor tiver o foco do teclado; caso contrário, FALSE.

[out, retval] range

Tipo: IUIAutomationTextRange**

Recebe um intervalo de texto que representa o local atual do cursor que pertence ao 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 parâmetro isActive for FALSE, o cursor que pertence ao controle baseado em texto poderá não estar no mesmo local que o cursor do sistema.

Esse método recupera um intervalo de texto que um cliente pode usar para localizar o retângulo delimitador do cursor que pertence ao controle baseado em texto ou para localizar o texto próximo ao cursor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (include UIAutomation.h)

Confira também

IUIAutomationTextPattern2

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

Trabalhando com controles baseados em texto