Partilhar via

Suporte de automação da interface do usuário para o tipo de controle TreeItem

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 TreeItem. 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 TreeItem representa um nó dentro de um contêiner de árvore. Cada nó pode conter outros nós, chamados nós filho. Os nós pai, ou nós que contêm nós filho, podem ser exibidos como expandidos ou recolhidos.

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 TreeItem. Os requisitos de automação da interface do usuário se aplicam a todos os controles de item de árvore, 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 apresenta a vista de controlo e a vista de conteúdo da árvore de Automação da Interface do Usuário que diz respeito aos controlos de itens de árvore e descreve o que pode ser contido em cada vista. 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
TreeItem

- CheckBox (0 ou 1)
- Imagem (0 ou 1)
- Botão (0 ou 1)
- TreeItem (0 ou mais)		 TreeItem

- TreeItem (0 ou mais)

Os controles de item de árvore podem ter zero ou mais filhos de item de árvore na exibição de conteúdo da árvore de Automação da Interface do Usuário. Se o controle de item de árvore tiver funcionalidade além do exposto nos padrões de controle listados abaixo, o controle deverá ser baseado no tipo de controle Item de Dados.

Os itens de árvore recolhidos não serão exibidos na visualização de controle ou na exibição de conteúdo até que se tornem expandidos e visíveis (ou possam ser rolados para a exibição).

A visualização de controle pode conter detalhes adicionais para um controle, incluindo uma imagem associada ou um botão. Por exemplo, um item em um modo de exibição de estrutura de tópicos pode conter uma imagem, bem como um botão para expandir ou recolher o contorno. Esses objetos de detalhe não aparecem na exibição de conteúdo porque as informações já estão representadas pelo item da árvore pai. Os itens de árvore que forem deslocados para fora do ecrã aparecerão nas vistas de controlo e conteúdo da árvore de Automação da Interface do Utilizador e deverão ter a configuração IsOffscreenProperty como true.

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 listar controles. 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.
ClickablePointProperty Ver notas. Essa propriedade deve retornar uma localização do item que fará com que o item altere o estado de seleção ou seja focado.
ControlTypeProperty TreeItem Esse valor é o mesmo para todas as estruturas de interface do usuário.
IsContentElementProperty Verdade O controle de lista é sempre incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário.
IsControlElementProperty Verdade O controle de lista é sempre incluído na exibição de controle da árvore de Automação da Interface do Usuário.
IsOffscreenProperty Ver notas. Esta propriedade é configurada para indicar quando um item de controlo da árvore é deslocado para fora do ecrã.
IsKeyboardFocusableProperty Ver notas. Se o controle pode receber foco do teclado, ele deve suportar essa propriedade.
ItemTypeProperty Ver notas. Se o controle de item de árvore usa um ícone visual para indicar que é um tipo específico de objeto, essa propriedade deve ser suportada e indicar qual é o objeto.
LabeledByProperty Null Os controles de item de árvore são autorrotulados.
LocalizedControlTypeProperty Elemento da árvore Cadeia de caracteres localizada correspondente ao tipo de controle TreeItem.
NameProperty Ver notas. Esta propriedade expõe o texto exibido para cada controle de item de árvore.

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 de lista. 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
IInvokeProvider Depende Implemente esse padrão de controle se o item de árvore tiver um comando separado e acionável.
IExpandCollapseProvider Sim Todos os itens da árvore podem ser expandidos ou recolhidos.
ExpandCollapseState Nó expandido, recolhido ou folha Os itens de árvore serão nós de folha quando não forem expandidos ou recolhidos.
IScrollItemProvider Depende Implemente esse padrão de controle se o contêiner de árvore suportar o padrão de controle Scroll.
ISelectionItemProvider Depende Implemente esse padrão de controle se for possível ter uma seleção ativa que seja mantida quando o usuário retornar ao contêiner de árvore.
SelectionContainer Sim Essa propriedade irá expor o mesmo contêiner para todos os itens dentro do contêiner.
IToggleProvider Depende Implemente esse padrão de controle se o item de árvore tiver uma caixa de seleção associada.

Eventos de automação da interface do usuário necessários

A tabela a seguir lista os eventos de Automação da Interface do Utilizador que todos os controles de item de árvore devem suportar. Para obter mais informações sobre eventos, consulte Visão geral eventos de automação da interface do usuário.

Evento de automação da interface do usuário Apoio Observações
AutomationFocusChangedEvent Obrigatório Nenhum
BoundingRectangleProperty evento de alteração de propriedade. Obrigatório Nenhum
IsEnabledProperty evento de alteração de propriedade. Obrigatório Nenhum
IsOffscreenProperty evento de alteração de propriedade. Obrigatório Nenhum
ItemStatusProperty evento de alteração de propriedade. Depende Nenhum
NameProperty evento de alteração de propriedade. Obrigatório Nenhum
StructureChangedEvent Obrigatório Nenhum
ExpandCollapseStateProperty evento de alteração de propriedade. Obrigatório Nenhum
InvokedEvent Depende Nenhum
CurrentViewProperty evento de alteração de propriedade. Depende Nenhum
ElementAddedToSelectionEvent Depende Nenhum
ElementRemovedFromSelectionEvent Depende Nenhum
ElementSelectedEvent Depende Nenhum
ToggleStateProperty evento de alteração de propriedade. Depende Nenhum
ValueProperty evento de alteração de propriedade. Depende Nenhum

Ver também

  • Last updated on