Implementando o padrão de controle SelectionItem de automação de interface do usuário

Este tópico apresenta diretrizes e convenções para a implementação ISelectionItemProviderIncluindo informações sobre propriedades, métodos e eventos.Links para referências adicionais são listadas no final da revisão.

O SelectionItemPattern Controle padrão é usada para oferecer suporte aos controles que atuam como Selec individual, Tabela que implementar controles itens filho do recipiente ISelectionProvedor.Para obter exemplos de controles que implementam o SelectionItem de controle padrão, consulte Mapeamento de Padrão de Controles para Clientes de Automação de IU

Este tópico contém as seguintes seções.

Orientações e Convenções de Implementação
Membros Requerridos para ISelectionItemProvider
Exceções
Tópicos relacionados

Orientações e Convenções de Implementação

Ao implementar o padrão de controle Selection Item, observe as seguintes diretrizes e convenções:

Controles de única seleção que Gerenciar que implementar controles filho IRawElementProvedorFragmentRootComo o Resolução de tela controle deslizante na Propriedades Exibir caixa de diálogo, deve implementar ISelectionProvedor e seus filhos devem implementar ambas IRawElementProviderFragment e ISelectionItemProvider.

Membros Requerridos para ISelectionItemProvider

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

Membros Requeridos	Tipo do membro	Anotações
CanSelectMultiple	Propriedade	Nenhum
IsSelectionRequired()	Propriedade	Nenhum
GetSelection	Método	Nenhum
InvalidatedEvent	Evento	Gerado quando uma seleção em um recipiente tem Alterado significativamente e requer enviando mais ElementSelectedEvent e ElementRemovedFromSelectionEvent Os eventos que o InvalidateLimit Constante permite.

Se o resultado de um [M:System.Windows.Automation.SelectionItemPadrão.Select]Um AddToSelectionou um RemoveFromSelection é um Simples item selecionado, um ElementSelectedEvent deve ser aumentado; Caso contrário, enviar ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent Conforme apropriado.

Exceções

Provedores precisam lançar as seguintes exceções.

Tipo de exceção	Condição
InvalidOperationException	Quando qualquer uma dos seguintes são tentadas: RemoveFromSelection() for chamado em um recipiente de única seleção onde IsSelectionRequiredProperty = verdadeiro e um elemento já está selecionado. RemoveFromSelection() for chamado em um Múltiplo - seleção recipiente onde IsSelectionRequiredProperty = verdadeiro e somente um elemento é selecionado. AddToSelection for chamado em um recipiente de única seleção onde CanSelectMultipleProperty = false e outro elemento já está selecionado.

InvalidOperationException

Quando qualquer uma dos seguintes são tentadas:

RemoveFromSelection() for chamado em um recipiente de única seleção onde IsSelectionRequiredProperty = verdadeiro e um elemento já está selecionado.
RemoveFromSelection() for chamado em um Múltiplo - seleção recipiente onde IsSelectionRequiredProperty = verdadeiro e somente um elemento é selecionado.
AddToSelection for chamado em um recipiente de única seleção onde CanSelectMultipleProperty = false e outro elemento já está selecionado.