Pattern di controllo SelectionItem

Vengono descritte le linee guida e le convenzioni per l'implementazione di ISelectionItemProvider, incluse informazioni su proprietà, metodi ed eventi. Il pattern di controllo SelectionItem viene usato per supportare i controlli che fungono da singoli elementi figlio selezionabili dei controlli contenitore che implementano ISelectionProvider.

Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.

In questo argomento sono contenute le sezioni seguenti.

• Linee guida e convenzioni di implementazione
• Membri obbligatori per ISelectionItemProvider
• Argomenti correlati

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo SelectionItem , tenere presenti le linee guida e le convenzioni seguenti:

• I controlli a selezione singola che gestiscono i controlli figlio che implementano IRawElementProviderFragmentRoot, ad esempio il dispositivo di scorrimento Risoluzione schermo nella finestra di dialogo Proprietà di visualizzazione per Windows, devono implementare ISelectionProvider; i figli devono implementare sia IRawElementProviderFragment che ISelectionItemProvider.

Membri obbligatori per ISelectionItemProvider

Per implementare l'interfaccia ISelectionItemProvider sono necessari i metodi e gli eventi seguenti.

Membri obbligatori	Tipo di membro	Note
AddToSelection	Metodo	Nessuno
Isselected	Proprietà	Nessuno
RemoveFromSelection	Metodo	Nessuno
Selezionare	Metodo	Nessuno
Selectioncontainer	Proprietà	Nessuno
UIA_SelectionItem_ElementAddedToSelectionEventId	Evento	Nessuno
UIA_SelectionItem_ElementRemovedFromSelectionEventId	Evento	Nessuno
UIA_SelectionItem_ElementSelectedEventId	Evento	Nessuno

 

Se il risultato di un oggetto Select, addToSelection o RemoveFromSelection è un singolo elemento selezionato, deve essere generato un evento ElementSelected (UIA_SelectionItem_ElementSelectedEventId); in caso contrario, generare eventi ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) o ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) in base alle esigenze.

Argomenti correlati

Tipi di controllo e modelli di controllo supportati

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente