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

Este tópico apresenta diretrizes e convenções para a implementação ISelectionProvedorIncluindo informações sobre eventos e propriedades.Links para referências adicionais são listadas ao final do tópico.

O SelectionPattern Controle padrão é usada para oferecer suporte aos controles que atuam como recipientes para uma coleção de Selec Tabela itens filhos.Os filhos deste elemento devem implementar ISelectionItemProvider.Para obter exemplos de controles que implementam esse padrão de controle, 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 ISelectionProvider
Exceções
Tópicos relacionados

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

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

Controles que implementam ISelectionProvedor Permitem que seja Simples ou vários filhos itens a ser selecionado.Por exemplo, caixa de listagem, modo de exibição de lista e modo de exibição de árvore oferecem suporte a múltipla seleção enquanto caixa de combinação, controle deslizante e grupo de botão de opção oferecem suporte a seleção única.
Controles que tenham um intervalo mínimo, máximo e contínuo, como o Volume controle deslizante, deve implementar IRangeValueProvider Em vez de ISelectionProvedor.
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 ou Selecionador de Cores Controle da seleção (ilustrado abaixo), deve implementar ISelectionProvedor; Seus filhos devem implementar ambas IRawElementProviderFragment e ISelectionItemProvider.

Exemplo de mapeamento de strings em uma amostra de cores

Menus não oferecem suporte SelectionPattern.Se você estiver trabalhando com itens de menu que incluem Ambos elementos gráficos e texto (como o Painel de Visualizar Itens na View Menu de e precisar transmitir estado, você deve implementar IToggleProvider.

Membros Requerridos para ISelectionProvider

A propriedades, métodos e eventos a seguir são necessários para o ISelectionProvedor Interface.

Membros Requeridos	Type (Tipo)	Anotações
CanSelectMultiple	Propriedade	Deve oferecer suporte ao Propriedade Alterada eventos usando AddAutomationPropertyChangedEventHandler e RemoveAutomationPropertyChangedEventHandler(Automationelemento, AutomationPropertyChangedEventHandler).
IsSelectionRequired()	Propriedade	Deve oferecer suporte ao Propriedade Alterada eventos usando AddAutomationPropertyChangedEventHandler e RemoveAutomationPropertyChangedEventHandler(Automationelemento, AutomationPropertyChangedEventHandler).
GetSelection	Método	Nenhum
InvalidatedEvent	Evento	Gerado quando uma seleção em um Contêiner mudou significativamente e requer enviando mais eventos de adição e remoção de InvalidateLimit Constante permite.

O IsSelectionRequired() e CanSelectMultiple As propriedades podem ser Dinâmico.Por exemplo, o estado inicial de um controle pode não ter os itens selecionados por padrão, indicando que IsSelectionRequired() é false.No entanto, depois que um item é selecionado, o controle deve sempre ter pelo menos um item selecionado.Da mesma forma, em casos raros, um controle pode permitir que vários itens sejam selecionados na inicialização, mas subseqüentemente permitir somente que seleções únicas sejam feitas.