Padrão de controle SelectionItem
Descreve diretrizes e convenções para implementar ISelectionItemProvider, incluindo informações sobre propriedades, métodos e eventos. O padrão de controle SelectionItem é 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 controles que implementam esse padrão de controle, consulte tipos de controle e seus padrões de controle com suporte.
Este tópico contém as seções a seguir.
- diretrizes e convenções de implementação
- membros necessários para ISelectionItemProvider
- tópicos relacionados
Diretrizes e convenções de implementação
Ao implementar o padrão de controle SelectionItem, observe as seguintes diretrizes e convenções:
- Controles de seleção única que gerenciam controles filho que implementam IRawElementProviderFragmentRoot, como o controle deslizante de Resolução de Tela na caixa de diálogo Propriedades de Exibição para Windows, devem implementar ISelectionProvider; seus filhos devem implementar IRawElementProviderFragment e ISelectionItemProvider.
Membros necessários para ISelectionItemProvider
As propriedades, métodos e eventos a seguir são necessários para implementar a interfaceISelectionItemProvider.
| Membros necessários | Tipo de membro | Anotações |
|---|---|---|
| AddToSelection | Método | Nenhum |
| IsSelected | Propriedade | Nenhum |
| RemoveFromSelection | Método | Nenhum |
| Selecionar | Método | Nenhum |
| SelectionContainer | Propriedade | Nenhum |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Acontecimento | Nenhum |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Acontecimento | Nenhum |
| UIA_SelectionItem_ElementSelectedEventId | Acontecimento | Nenhum |
Se o resultado de um Select, um AddToSelectionou um RemoveFromSelection for um único item selecionado, um evento ElementSelected (UIA_SelectionItem_ElementSelectedEventId) deverá ser acionado; caso contrário, gere eventos ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) ou ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) conforme apropriado.
Tópicos relacionados