Partilhar via

Suporte de automação da interface do 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 da interface do usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

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 diretrizes específicas para a estrutura da árvore de Automação da Interface do Usuário, valores de propriedade da Automação da Interface do Usuário e 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 da Interface do Usuário, propriedades, padrões de controle e 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 Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Estrutura de árvore de automação da interface do usuário necessária

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

Vista de Controlo Visualização de conteúdo
Barra de rolagem

- Botão (2 ou 4)
- Polegar (0 ou 1)		 Não aplicável. O controle da barra de rolagem não contém conteúdo.

O controle da 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 detetá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 de 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 através do padrão de controle Scroll, que é suportado no contêiner que está sendo rolado.

Para obter mais informações sobre as propriedades de 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 Observações
AutomationIdProperty Ver notas. O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo.
BoundingRectangleProperty Ver notas. O retângulo mais externo que contém todo o controle.
IsKeyboardFocusableProperty Ver notas. Se o controle pode receber foco do teclado, ele deve suportar essa propriedade.
NameProperty Null O controle de barra de rolagem não tem elementos de conteúdo e não é necessário definir o NameProperty .
ClickablePointProperty Não é um número. O controle da 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 Slider.
LocalizedControlTypeProperty Barra de rolagem Cadeia de caracteres localizada que corresponde ao tipo de controle Button.
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 Slider e retornar ControlType.Slider para a propriedade ControlType.
IsControlElementProperty Verdade A barra de rolagem deve ser sempre um 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 da interface do usuário necessários

A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados pelos controles da barra de rolagem. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário. Observe que quando uma barra de rolagem é usada como um controle apenas para manipulação do mouse, ela não suporta padrões de controle. Se ele for usado como um controle deslizante dentro de um aplicativo, ele deve receber o tipo de controle Slider.

Padrão de controle Apoio Observações
IScrollProvider Nunca O padrão de controle Scroll nunca é suportado diretamente na barra de rolagem.
IRangeValueProvider Depende Essa funcionalidade deve ser suportada somente se o padrão de controle Scroll não for suportado no contêiner que tem a barra de rolagem.

Eventos de automação da 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 Observações
BoundingRectangleProperty evento de alteração de propriedade. Obrigatório Nenhum
IsOffscreenProperty evento de alteração de propriedade. Obrigatório Nenhum
IsEnabledProperty evento de alteração de propriedade. Obrigatório Nenhum
HorizontallyScrollableProperty evento de alteração de propriedade. Nunca Nenhum
HorizontalScrollPercentProperty evento de alteração de propriedade. Nunca Nenhum
HorizontalViewSizeProperty evento de alteração de propriedade. Nunca Nenhum
VerticalScrollPercentProperty evento de alteração de propriedade. Nunca Nenhum
VerticallyScrollableProperty evento de alteração de propriedade. Nunca Nenhum
VerticalViewSizeProperty evento de alteração de propriedade. Nunca Nenhum
ValueProperty evento de alteração de propriedade. Depende Nenhum
AutomationFocusChangedEvent Obrigatório Nenhum
StructureChangedEvent Obrigatório Nenhum

Ver também

  • Last updated on