Compartilhar via

Método IUIAutomationTextRange::ScrollIntoView (uiautomationclient.h)

  • Artigo

Faz com que o controle de texto role até que o intervalo de texto esteja visível no visor.

Sintaxe

HRESULT ScrollIntoView(
  [in] BOOL alignToTop
);

Parâmetros

[in] alignToTop

Tipo: BOOL

TRUE se o controle de texto deve ser rolado para que o intervalo de texto seja liberado com a parte superior do visor; FALSE se ele deve ser liberado com a parte inferior do visor.

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

O método respeita o texto oculto e visível. Se o intervalo de texto estiver oculto, o controle de texto será rolado somente se o texto oculto tiver uma âncora no visor.

Um cliente do Microsoft Automação da Interface do Usuário pode marcar visibilidade de texto chamando IUIAutomationTextRange::GetAttributeValue com o parâmetro attr definido como UIA_IsHiddenAttributeId.

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

IUIAutomationTextRange

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