Partilhar via


UI Automation Support for the Pane Control Type

Este tópico fornece informações sobre Suporte para o painel 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.

O tipo de controle Pane é usado para representar um objeto dentro de uma moldura ou janela do documento.Os usuários podem navegar de um controles de painel para o outro e dentro do conteúdo do painel atual, mas não podem navegar entre os itens de diferentes painéis.Assim, controles de painel representam um nível de agrupamento abaixo das janelas ou documentos, mas acima dos controles individuais.O usuário navega entre os painéis pressionando TAB, F6 ou CTRL + TAB, dependendo do contexto.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o Painel de controle tipo.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 pertence ao painel controla e descreve o que pode estar contido em cada modo de exibição.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

  • Pane

  • Pane

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles painel.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

Veja anotações.

O valor para essa propriedade sempre deve ser um título claro, conciso e significativo.

ClickablePointProperty

Veja anotações.

Essa propriedade expõe um ponto clicável do controle de painel que faz com que o painel entre em foco quando ele for clicado.

LabeledByProperty

Veja anotações.

Controles de painel geralmente não têm um rótulo estático.Se houver um rótulo de texto estático, ele deve ser exposto através desta propriedade.

ControlTypeProperty

Pane

Esse valor é o mesmo para todos As estruturas.

LocalizedControlTypeProperty

"painel"

String localizada correspondente ao tipo de controle de Pane.

IsContentElementProperty

True

Painel controles sempre são incluídos na exibição do conteúdo de árvore.

IsControlElementProperty

True

Painel controles sempre são incluídos na exibição de controle de árvore.

HelpTextProperty

""

O texto de ajuda para controles de painel deve explicar o objetivo do quadro e como ele se relaciona com outros quadros.Uma descrição é necessária se a finalidade e relacionamento de quadros não for Limpar do valor das NameProperty.”

AccessKeyProperty

Veja anotações.

Se uma determinada combinação de teclas concede o foco para o painel, então essas informações devem ser expostas através desta propriedade.

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

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por todos os controles painel.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.

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

Suporte/Valor

Anotações

ITransformProvider

Depende

Implemente esse padrão de controle se o controle de painel puder ser movido, redimensionado, ou rotacionado na tela.

IWindowProvider

Nunca

Se você precisar implementar esse padrão de controle, o controle deve ser baseado na Window() Controle tipo.

IDockProvedor

Depende

Implemente esse padrão de controle se o controle de painel puder ser encaixado.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles painel.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

WindowClosedEvent

Nunca

Nenhum

WindowOpenedEvent

Nunca

Nenhum

AsyncContentLoadedEvent

Necessário

Nenhum

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.

Depende

Nenhum

HorizontalScrollPercentProperty Evento de propriedade alterado.

Depende

Nenhum

HorizontalViewSizeProperty Evento de propriedade alterado.

Depende

Nenhum

VerticalScrollPercentProperty Evento de propriedade alterado.

Depende

Nenhum

VerticallyScrollableProperty Evento de propriedade alterado.

Depende

Nenhum

VerticalViewSizeProperty Evento de propriedade alterado.

Depende

Nenhum

WindowVisualStateProperty Evento de propriedade alterado.

Nunca

Nenhum

AutomationFocusChangedEvent

Necessário

Nenhum

StructureChangedEvent

Necessário

Nenhum

Exemplo do tipo de controle Pane

A imagem a seguir ilustra um controle que implementa o tipo de controle Pane.

Exibir de controle - árvore

Árvore - exibir conteúdo

  • Pane

  • Tree (padrão Scroll)

    • TreeItem

  • Pane

  • Editar

Consulte também

Conceitos

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

UI Automation Overview

Referência

Pane()