Partilhar via


UI Automation Support for the ScrollBar Control Type

Este tópico fornece informações sobre Suporte para o ScrollBar Tipo de controle.Em Um tipo de controle é um conjunto de condições que um controle deve atender em Ordem para usar o ControlTypeProperty Propriedade.As condições incluem guia específico linhas para estrutura de árvore, valores de propriedade e Padrões de Controlarar.

Controles de barra de rolagem permitem que um usuário role o conteúdo em uma janela ou contêiner de itens.O controle é composto de um conjunto de botões e um controle polegar.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de Controlarar e eventos para o tipo de Controlarar Barra de Rolagem.O Requisitos Aplicar para todos Lista controles, se , Win32, ou .

Este tópico contém as seguintes seções.

Estrutura de Árvore de Automação de IU Requerida

A tabela a seguir descreve o Modo de controle e o exibição de conteúdo do Árvore que diz respeito a barra de rolagem controles e descreve o que pode estar contido em cada Exibir.Para obter mais informações sobre o árvore, consulte Visão geral da árvore de automação de interface do usuário.

Visão de Controle

Visão de Conteúdo

  • ScrollBar

    • Botão (2 ou 4)

    • Polegar (0 ou 1)

O controle barra de rolagem não contém conteúdo.

O controle barra de rolagem sempre tem entre três e cinco filhos.Porque a subárvore tem Mais de controle de botão um, você deve definir um determinado AutomationIdProperty() Valor para cada item para torná-los identificável para ferramentas de automação de teste.

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles barra de rolagem.Anotação que um controle barra de rolagem nunca tem conteúdo; sua funcionalidade é exposta através de rolagem controle padrãoque tem suporte no Contêiner que está sendo feita a rolagem.

Para obter mais informações propriedades, consulte UI Automation Properties for Clients.

Propriedade

Value (Valor)

Anotações

AutomationIdProperty()

Veja anotações.

O valor desta propriedade precisa ser único em todos os controles de uma aplicação.

BoundingRectangleProperty

Veja anotações.

O retângulo mais externo que contém o controle inteiro.

IsKeyboardFocusableProperty

Veja anotações.

Se o controle pode receber o foco do teclado, deve suportar essa propriedade.

NameProperty

Null

O controle barra de rolagem não tem elementos de conteúdo e a NameProperty Não é necessária a ser definido.

ClickablePointProperty

Não um número.

O controle barra de rolagem não possui pontos clicáveis.

LabeledByProperty

Null

As barras de rolagem não têm rótulos.

ControlTypeProperty

ScrollBar

Este valor é o mesmo para todos frameworks .Barras de rolagem que funcionam como controles deslizantes devem usar o tipo de controle Slider.

LocalizedControlTypeProperty

"barra de rolagem"

String localizada que corresponde ao tipo de controle Button.

IsContentElementProperty

Falso

O controle barra de rolagem nunca é um elemento de conteúdo.Se o barra de rolagem é um controle autônomo, em seguida, ele deve ful Preencher o controle deslizante controle Tipo e retornar Controltipo.Slider Para o ControlType Propriedade.

IsControlElementProperty

True

A barra de rolagem deve sempre ser um controle.

OrientationProperty

True

O controle barra de rolagem sempre deve expor sua orientação horizontal ou vertical.

Padrões de Controle de Automação de IU Requeridos

O seguinte tabela Listas o Padrões de Controlarar Necessário para ser suportadas por controles barra de rolagem.Para obter mais informações sobre padrões de controle, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.Observe que quando um barra de rolagem é usada como um controle para manipulação exclusivamente através do mouse, ela não oferece suporte a padrões de controle.Se ele é usado como um controle deslizante dentro de um aplicativo, ele deve receber o tipo de controle Slider.

Padrão de Controle/Propriedade de Padrão de Controle

Suporte/Valor

Anotações

IScrollProvider

Nunca

O padrão de controle Scroll nunca recebe suporte direto na barra de rolagem.

IRangeValueProvider

Depende

Essa funcionalidade precisa ser suportada apenas se o padrão de controle Scroll não for suportado no contêiner que possui a barra de rolagem.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por Tudo controles barra de rolagem.Para obter mais informações sobre eventos, consulte Visão geral sobre eventos de automação de interface do usuário.

Evento

Suporte/Valor

Anotações

BoundingRectangleProperty Evento de propriedade alterado.

Necessário

Nenhum

IsOffscreenProperty Evento de propriedade alterado.

Necessário

Nenhum

IsEnabledProperty Evento de propriedade alterado.

Necessário

Nenhum

HorizontallyScrollableProperty Evento de propriedade alterado.

Nunca

Nenhum

HorizontalScrollPercentProperty Evento de propriedade alterado.

Nunca

Nenhum

HorizontalViewSizeProperty Evento de propriedade alterado.

Nunca

Nenhum

VerticalScrollPercentProperty Evento de propriedade alterado.

Nunca

Nenhum

VerticallyScrollableProperty Evento de propriedade alterado.

Nunca

Nenhum

VerticalViewSizeProperty Evento de propriedade alterado.

Nunca

Nenhum

ValueProperty Evento de propriedade alterado.

Depende

Nenhum

AutomationFocusChangedEvent

Necessário

Nenhum

StructureChangedEvent

Necessário

Nenhum

Consulte também

Conceitos

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

UI Automation Overview

Referência

ScrollBar