Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 Tab. 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, para os valores de suas propriedades e para a automação em geral. padrões de controlo.
Um controle de tabulação é análogo aos divisores em um bloco de anotações ou às etiquetas em um gabinete de arquivos. Usando um controle de guia, um aplicativo pode definir várias páginas para a mesma área de uma janela ou caixa de diálogo.
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 Tab. Os requisitos de automação da interface do usuário se aplicam a todos os controles de guia, 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 a exibição de controle e a exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence aos controles de guia 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 |
|---|---|
Separador
|
Separador - TabItem (1 ou mais) |
Os controlos Tab têm elementos filho de Automação da Interface do Utilizador com o tipo de controlo Tab Item como base. Quando os itens de guia são agrupados (por exemplo, como em aplicativos do Microsoft Office 2007), o tipo de controle Tab também pode hospedar tipos de controle Grupos para os itens de guia agrupados, como mostra a estrutura de árvore a seguir.
| Vista de Controlo | Visualização de conteúdo |
|---|---|
Separador
|
Separador
|
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 o tipo de controle Tab. 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 controle tab raramente requer uma propriedade Name. |
| ClickablePointProperty | Não | O controle tab não tem um ponto clicável. |
| LabeledByProperty | Ver notas. | Os controles de guia normalmente têm um rótulo de texto estático que é exposto por meio dessa propriedade. |
| ControlTypeProperty | Separador | Esse valor é o mesmo para todas as estruturas de interface do usuário. |
| LocalizedControlTypeProperty | "Guia" | Cadeia de caracteres localizada correspondente ao tipo de controle Tab. |
| IsKeyboardFocusableProperty | Verdade | O tipo de controle Tab deve ser capaz de receber o foco do teclado. Normalmente, um cliente de automação da interface do usuário chama SetFocus em um controle de guia e um de seus itens encaminhará o foco do teclado para o controle de guia. É possível que alguns contêineres de guias tomem o foco sem definir o foco para um de seus itens. |
| IsContentElementProperty | Verdade | O controle de guia é sempre incluído na exibição de conteúdo da árvore de automação da interface do usuário. |
| IsControlElementProperty | Verdade | O controle de guia é sempre incluído na visualização de controle da árvore de Automação da Interface do Usuário. |
| OrientationProperty | Ver notas. | O controle tab deve sempre indicar se está posicionado horizontal ou verticalmente. |
Padrões e propriedades 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 guia. 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.
| Propriedade Control Pattern/Pattern | Suporte/Valor | Observações |
|---|---|---|
| ISelectionProvider | Sim | Todos os controles de guia devem suportar o padrão Seleção. |
| IsSelectionRequired | Verdade | Os controles de tabulação sempre exigem que uma seleção seja feita. |
| CanSelectMultiple | Falso | Os controles de tabulação são sempre contêineres de seleção única. |
| IScrollProvider | Depende | O padrão Scroll deve ser suportado no controlo de tabulação, que inclui widgets que permitem rolar através de um conjunto de itens de guia. |
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 guia. 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 | Apoio | 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. | Depende | Nenhum |
| HorizontalScrollPercentProperty evento de alteração de propriedade. | Depende | Nenhum |
| HorizontallyScrollableProperty 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 |
| VerticalViewSizeProperty evento de alteração de propriedade. | Depende | Nenhum |
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |
Ver também
- Tab
- Visão geral dos tipos de controle de Automação de UI
- Visão geral da automação da interface do usuário