Implementando o padrão de controle SelectionItem da automação da interface do usuá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 apresenta diretrizes e convenções para implementar ISelectionItemProvider, incluindo informações sobre propriedades, métodos e eventos. Os links para referências adicionais estão listados no final da visão geral.

O padrão de controle SelectionItemPattern é usado para dar suporte a controles que atuam como itens filho individuais e selecionáveis de controles de contêiner que implementam ISelectionProvider. Para obter exemplos de controlos que implementam o padrão de controlo SelectionItem, consulte mapeamento de padrões de controlo para clientes de automação de interface.

Orientações e convenções de aplicação

Ao implementar o padrão de controlo Elemento de Seleção, observe as seguintes diretrizes e convenções:

• Os controles de seleção única que gerenciam controles filho que implementam IRawElementProviderFragmentRoot, como o controle deslizante Resolução de Tela na caixa de diálogo Propriedades de Exibição , devem implementar ISelectionProvider e seus filhos devem implementar IRawElementProviderFragment e ISelectionItemProvider.

Membros necessários para ISelectionItemProvider

As seguintes propriedades, métodos e eventos são necessários para implementar ISelectionItemProvider.

Membros obrigatórios	Tipo de membro	Observações
IsSelected	Propriedade	Nenhum
SelectionContainer	Propriedade	Nenhum
AddToSelection	Método	Nenhum
RemoveFromSelection	Método	Nenhum
Select	Método	Nenhum
ElementSelectedEvent	Evento	Gerado quando uma alteração de seleção leva a um único item selecionado.
ElementAddedToSelectionEvent	Evento	Gerado quando um item é adicionado a um contêiner de seleção múltipla.
ElementRemovedFromSelectionEvent	Evento	Gerado quando um item é removido de um contêiner de seleção múltipla.
InvalidatedEvent	Evento	Gerado quando uma seleção num contentor mudou significativamente e requer o envio de mais eventos ElementSelectedEvent e ElementRemovedFromSelectionEvent do que o constante InvalidateLimit permite.

• Se uma operação Select, AddToSelectionou RemoveFromSelection resultar em um único item selecionado, levante ElementSelectedEvent; caso contrário, levante ElementAddedToSelectionEvent ou ElementRemovedFromSelectionEvent, conforme apropriado.

Exceções

Os provedores devem lançar as seguintes exceções.

Tipo de exceção

Condição

InvalidOperationException

Quando qualquer uma das seguintes situações for tentada: - RemoveFromSelection é chamado em um contêiner de seleção única onde IsSelectionRequiredProperty = true e um elemento já estão selecionados. - RemoveFromSelection é chamado em um contêiner de seleção múltipla onde IsSelectionRequiredProperty = true e apenas um elemento é selecionado. - AddToSelection é chamado em um contêiner de seleção única onde CanSelectMultipleProperty = false e outro elemento já estão selecionados.

Ver também

• Visão geral dos padrões de controlo de automação da interface do utilizador
• Suportar Padrões de Controle em um Provedor de Automação de Interface do Usuário
• Padrões de Controle de Automação da Interface do Usuário para Clientes
• Implementando o padrão de controle de seleção de automação da interface do usuário
• Visão geral da árvore de automação da interface do usuário
• Use o armazenamento em cache na automação da interface do utilizador
• Exemplo de fornecedor de fragmentos