Partilhar via

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

  • Artigo

Nota

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 System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.

Este tópico apresenta diretrizes e convenções para implementação ISelectionProvider, incluindo informações sobre eventos e propriedades. Links para referências adicionais estão listados no final do tópico.

O SelectionPattern padrão de controle é usado para dar suporte a controles que atuam como contêineres para uma coleção de itens filho selecionáveis. 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 controle para clientes de automação da interface do usuário.

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

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

  • Os controles que implementam ISelectionProvider permitem que um ou vários itens filho sejam selecionados. Por exemplo, a caixa de listagem, o modo de exibição de lista e o modo de exibição de árvore suportam várias seleções, enquanto a caixa de combinação, o controle deslizante e o grupo de botões de opção suportam uma única seleção.

  • Os controles que têm um intervalo mínimo, máximo e contínuo, como o controle deslizante Volume , 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 ou o controle de seleção do Seletor de Cores do Microsoft Word (ilustrado abaixo), devem implementar ISelectionProvider; seus filhos devem implementar ambos IRawElementProviderFragment e ISelectionItemProvider.

Color picker with yellow highlighted. Exemplo de mapeamento de cadeia de caracteres de amostra de cores

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

Membros necessários para ISelectionProvider

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

Membros obrigatórios Type Notas
CanSelectMultiple Property Deve suportar eventos alterados de propriedade usando AddAutomationPropertyChangedEventHandler e RemoveAutomationPropertyChangedEventHandler.
IsSelectionRequired Property Deve suportar eventos alterados de propriedade usando AddAutomationPropertyChangedEventHandler e RemoveAutomationPropertyChangedEventHandler.
GetSelection Método Nenhuma
InvalidatedEvent Evento Gerado quando uma seleção em um contêiner mudou significativamente e requer o envio de mais eventos de adição e remoção do que as InvalidateLimit constantes permitem.

As IsSelectionRequired propriedades e CanSelectMultiple podem ser dinâmicas. 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.

Exceções

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

Tipo de Exceção Condição
ElementNotEnabledException Se o controle não estiver habilitado.
InvalidOperationException Se o controle estiver oculto.

Consulte também