Suporte de automação de interface de usuário para o tipo de controle ScrollBar

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de Automação de Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre Automação de Interface do Usuário, consulte API de Automação do Windows: Automação de Interface do Usuário.

Este tópico fornece informações sobre o suporte à Automação da Interface do Usuário para o tipo de controle ScrollBar. Na Automação da Interface do Usuário, um tipo de controle é um conjunto de condições que um controle deve atender para usar a ControlTypeProperty propriedade. As condições incluem as diretrizes específicas para estrutura de árvore de automação da IU, os valores de propriedade de Automação da Interface do Usuário e os padrões de controle.

Os controles da barra de rolagem permitem que um usuário role o conteúdo dentro de uma janela ou contêiner de item. O controle é composto por um conjunto de botões e um controle de polegar.

As seções a seguir definem a estrutura da árvore de automação de IU, as propriedades, os padrões de controle e os eventos necessários para o tipo de controle ScrollBar. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de lista, seja o WPF (Windows Presentation Foundation), o Win32 ou o Windows Forms.

Estrutura de árvore de Automação da IU necessária

A tabela a seguir ilustra as visualizações de controle e de conteúdo da árvore de Automação da Interface do Usuário relacionadas aos controles da barra de rolagem e descreve o que pode ser contido em cada visualização. Para obter mais informações sobre a árvore de Automação da Interface do Usuário, consulte a visão geral da árvore de automação da interface do usuário.

Modo de Exibição de Controle	Exibição de conteúdo
Barra de Rolagem - Botão (2 ou 4) - Posição (0 ou 1)	Não aplicável. O controle da barra de rolagem não contém conteúdo.

O controle de barra de rolagem sempre tem de três a cinco filhos. Como a subárvore tem mais de um controle de botão, você deve definir um valor específico AutomationIdProperty para cada item para torná-los detectáveis para ferramentas de automação de teste.

Propriedades de automação da interface do usuário necessárias

A tabela a seguir lista as propriedades da Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para controles de barra de rolagem. Observe que um controle de barra de rolagem nunca tem conteúdo; sua funcionalidade é exposta por meio do padrão de controle de rolagem, que é suportado pelo contêiner que está sendo rolado.

Para obter mais informações sobre as propriedades da Automação da Interface do Usuário, consulte Propriedades de Automação da Interface do Usuário para clientes.

Propriedade de Automação da interface do usuário	Valor	Anotações
AutomationIdProperty	Confira as anotações.	O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo.
BoundingRectangleProperty	Confira as anotações.	O retângulo mais externo que contém todo o controle.
IsKeyboardFocusableProperty	Confira as anotações.	Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade.
NameProperty	Null	O controle da barra de rolagem não tem elementos de conteúdo e o NameProperty não é necessário para ser definido.
ClickablePointProperty	Não é um número.	O controle de barra de rolagem não tem pontos clicáveis.
LabeledByProperty	Null	As barras de rolagem não têm rótulos.
ControlTypeProperty	Barra de Rolagem	Esse valor é o mesmo para todas as estruturas. As barras de rolagem que funcionam como controles deslizantes devem usar o tipo de controle deslizante.
LocalizedControlTypeProperty	"barra de rolagem"	Texto localizado que corresponde ao tipo de controle de botão.
IsContentElementProperty	Falso	O controle da barra de rolagem nunca é um elemento de conteúdo. Se a barra de rolagem for um controle autônomo, ela deverá cumprir o tipo de controle deslizante e retornar ControlType.Slider para a propriedade ControlType.
IsControlElementProperty	Verdade	A barra de rolagem deve sempre ser um elemento de controle.
OrientationProperty	Verdade	O controle da barra de rolagem deve sempre expor sua orientação horizontal ou vertical.

Padrões de controle de automação de interface do usuário necessários

A tabela a seguir lista os padrões de controle de automação da Interface do Usuário (IU) que devem ser suportados por controles de barra de rolagem. Para obter mais informações sobre padrões de controle, consulte Visão geral dos padrões de controle de automação da interface do usuário. Observe que quando uma barra de rolagem é usada como um controle somente para manipulação de mouse, ela não dá suporte a padrões de controle. Se ele for usado como um controle deslizante dentro de um aplicativo, ele deverá receber o tipo de controle deslizante.

Padrão de controle	Apoio	Anotações
IScrollProvider	Nunca	O padrão de controle Rolar nunca tem suporte direto na barra de rolagem.
IRangeValueProvider	Depende	Essa funcionalidade deve ter suporte apenas se o padrão de controle de rolagem não for suportado pelo contêiner que possui a barra de rolagem.

Eventos de automação de interface do usuário necessários

A tabela a seguir lista os eventos de Automação da Interface do Usuário necessários para serem suportados por todos os controles da barra de rolagem. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário.

Evento de automação da interface do usuário	Suporte/valor	Anotações
BoundingRectangleProperty evento de alteração da propriedade.	Obrigatório	Nenhum
IsOffscreenProperty evento de alteração da propriedade.	Obrigatório	Nenhum
IsEnabledProperty evento de alteração da propriedade.	Obrigatório	Nenhum
HorizontallyScrollableProperty evento de alteração da propriedade.	Nunca	Nenhum
HorizontalScrollPercentProperty evento de alteração da propriedade.	Nunca	Nenhum
HorizontalViewSizeProperty evento de alteração da propriedade.	Nunca	Nenhum
VerticalScrollPercentProperty evento de alteração da propriedade.	Nunca	Nenhum
VerticallyScrollableProperty evento de alteração da propriedade.	Nunca	Nenhum
VerticalViewSizeProperty evento de alteração da propriedade.	Nunca	Nenhum
ValueProperty evento de alteração da propriedade.	Depende	Nenhum
AutomationFocusChangedEvent	Obrigatório	Nenhum
StructureChangedEvent	Obrigatório	Nenhum

Consulte também

• ScrollBar
• Visão geral dos tipos de controle de automação da interface do usuário
• Visão geral da automação da interface do usuário