Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 Pane. 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.
O tipo de controle Pane é usado para representar um objeto dentro de um quadro ou janela de documento. Os usuários podem navegar entre controles de painel e dentro do conteúdo do painel atual, mas não podem navegar entre itens em painéis diferentes. Assim, os controles de painel representam um nível de agrupamento inferior a janelas ou documentos, mas acima de controles individuais. O usuário navega entre painéis pressionando TAB, F6 ou CTRL+TAB, dependendo do contexto. Nenhuma navegação de teclado específica é exigida pelo tipo de controle Pane.
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 Pane. 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 de painel e descreve o que pode ser contido em cada modo de 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 |
|---|---|
| Painel | Painel |
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 painel. 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 | Ver notas. | O valor deste imóvel deve ser sempre um título claro, conciso e significativo. |
| ClickablePointProperty | Ver notas. | Essa propriedade expõe um ponto clicável do controle de painel que faz com que o painel se concentre quando é clicado. |
| LabeledByProperty | Ver notas. | Os controles de painel normalmente não têm um rótulo estático. Se houver um rótulo de texto estático, ele deve ser exposto por meio dessa propriedade. |
| ControlTypeProperty | Painel | Esse valor é o mesmo para todas as estruturas de interface do usuário. |
| LocalizedControlTypeProperty | "Painel" | Cadeia de caracteres localizada correspondente ao tipo de controle Pane. |
| IsContentElementProperty | Verdade | Os controles de painel são sempre incluídos na exibição de conteúdo da árvore de Automação da Interface do Usuário. |
| IsControlElementProperty | Verdade | Os controles de painel são sempre incluídos na visualização de controle da árvore de Automação da Interface do Usuário. |
| HelpTextProperty | "" | O texto de ajuda para controles de painel deve explicar por que a finalidade do quadro e como ele se relaciona com outros quadros. Uma descrição é necessária se a finalidade e a relação dos quadros não forem claras a partir do valor do NameProperty. "" |
| AccessKeyProperty | Ver notas. | Se uma combinação de teclas específica der foco ao painel, essas informações deverão ser expostas por meio dessa propriedade. |
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 por todos os controles de painel. 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.
| Padrão de controle | Apoio | Observações |
|---|---|---|
| ITransformProvider | Depende | Implemente esse padrão de controle se o controle de painel puder ser movido, redimensionado ou girado na tela. |
| IWindowProvider | Nunca | Se você precisar implementar esse padrão de controle, seu controle deve ser baseado no Window tipo de controle. |
| IDockProvider | Depende | Implemente esse padrão de controle se o controle de painel puder ser encaixado. |
| IScrollProvider | Depende | Implemente esse padrão de controle se o controle de painel puder ser rolado. |
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 de painel. 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 |
|---|---|---|
| WindowClosedEvent | Nunca | Nenhum |
| WindowOpenedEvent | Nunca | Nenhum |
| AsyncContentLoadedEvent | Obrigatório | Nenhum |
| 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. | Depende | Nenhum |
| HorizontalScrollPercentProperty evento de alteração de propriedade. | Depende | Nenhum |
| HorizontalViewSizeProperty evento de alteração de propriedade. | Depende | Nenhum |
| VerticalScrollPercentProperty evento de alteração de propriedade. | Depende | Nenhum |
| VerticallyScrollableProperty evento de alteração de propriedade. | Depende | Nenhum |
| VerticalViewSizeProperty evento de alteração de propriedade. | Depende | Nenhum |
| WindowVisualStateProperty evento de alteração de propriedade. | Nunca | Nenhum |
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |
Exemplo de tipo de controle de painel
A imagem a seguir ilustra um controle que implementa o tipo de controle Pane.
| Árvore de automação da interface do usuário - Visualização de controle | Árvore de automação da interface do usuário - Visualização de conteúdo |
|---|---|
|
- Painel - Árvore (padrão de scroll) - TreeItem - … Painel - Editar - (Padrão de rolagem) |
Ver também
- Pane
- Visão geral dos tipos de controle de Automação de UI
- Visão geral da automação da interface do usuário