Padrão de controle de seleção

Descreve diretrizes e convenções para implementar ISelectionProvider , incluindo informações sobre propriedades, métodos e eventos. O padrão de controle Seleção de é usado para dar suporte a controles que atuam como contêineres para uma coleção de itens filho selecionáveis. Os filhos desse elemento devem implementar ISelectionItemProvider.

Para obter exemplos de controles que implementam esse padrão de controle, consulte tipos de controle e seus padrões de controle suportados.

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

• Diretrizes de Implementação e Convenções
• Membros necessários para ISelectionProvider
• Tópicos relacionados

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

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

• Os controles que implementam ISelectionProvider permitem que um ou vários itens filho sejam selecionados. Por exemplo, caixas de listagem, modos de exibição de lista e modos de exibição de árvore oferecem suporte a várias seleções, enquanto caixas de combinação, controles deslizantes e grupos de botões de opção oferecem suporte a seleção única.

• Os controles que têm um intervalo mínimo, máximo e contínuo, como o controle deslizante Volume de um media player, devem implementar IRangeValueProvider em vez de ISelectionProvider.

• 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 para Windows, ou o controle de seleção Seletor de Cores do Microsoft Word (consulte a imagem a seguir), devem implementar ISelectionProvider; seus filhos devem implementar IRawElementProviderFragment e ISelectionItemProvider.

  

• Os menus não suportam o padrão de de controle Seleção. Se você estiver trabalhando com itens de menu que incluem elementos gráficos e texto (como o Painel de Visualização itens no menu Exibir no Microsoft Outlook) e precisar transmitir o estado, implemente IToggleProvider.

Membros necessários para ISelectionProvider

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

O ISelectionProvider::IsSelectionRequired e propriedades CanSelectMultiple podem ser dinâmicos. Por exemplo, o estado inicial de um controle pode não ter nenhum item selecionado por padrão, indicando que IsSelectionRequired é false. No entanto, depois que um item é selecionado, o controle sempre deve 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 subsequentemente permitir que apenas seleções únicas sejam feitas.

Tópicos relacionados

tipos de controle e seus padrões de controle suportados

padrão de controle SelectionItem

Visão geral dos padrões de controle de automação da interface do do usuário

Visão geral da árvore de automação da interface do usuário