Implementazione del pattern di controllo SelectionItem di automazione interfaccia utente

Aggiornamento: novembre 2007

In questo argomento vengono presentate linee guida e convenzioni per l'implementazione di ISelectionItemProvider, incluse informazioni su proprietà, metodi ed eventi. Alla fine dell'argomento sono elencati i collegamenti a ulteriori riferimenti.

Il pattern di controllo SelectionItemPattern viene utilizzato per supportare i controlli che agiscono da singoli elementi figlio selezionabili di controlli contenitore che implementano ISelectionProvider. Per alcuni esempi di controlli che implementano il pattern di controllo SelectionItem, vedere Mapping dei pattern di controllo per i client di automazione interfaccia utente

Nel presente argomento sono contenute le seguenti sezioni.

Linee guida e convenzioni per l'implementazione
Membri obbligatori per ISelectionItemProvider
Eccezioni
Argomenti correlati

Linee guida e convenzioni per l'implementazione

Quando si implementa il pattern di controllo Selection Item, 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 dello schermo della finestra di dialogo Proprietà dello schermo, devono implementare ISelectionProvider, mentre i relativi elementi figlio devono implementare IRawElementProviderFragment e ISelectionItemProvider.

Membri obbligatori per ISelectionItemProvider

Le proprietà, i metodi e gli eventi seguenti sono obbligatori per l'implementazione di ISelectionItemProvider.

Membri obbligatori	Tipo di membro	Note
CanSelectMultiple	Proprietà	Nessuna
IsSelectionRequired	Proprietà	Nessuna
GetSelection	Metodo	Nessuna
InvalidatedEvent	Evento	Viene generato quando una selezione in un contenitore ha subito modifiche significative e richiede l'invio di un numero di eventi ElementSelectedEvent e ElementRemovedFromSelectionEvent maggiore di quello consentito dalla costante InvalidateLimit.

Se il risultato di un metodo Select, AddToSelection o RemoveFromSelection è un elemento a selezione singola, è necessario generare un evento ElementSelectedEvent. In caso contrario, inviare ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent come appropriato.

Eccezioni

I provider devono generare le eccezioni seguenti.

Tipo di eccezione	Condizione
InvalidOperationException	Quando viene eseguito uno dei tentativi seguenti: Viene chiamato il metodo RemoveFromSelection su un contenitore a selezione singola in cui IsSelectionRequiredProperty = true e un elemento è già selezionato. Viene chiamato il metodo RemoveFromSelection su un contenitore a selezione multipla in cui IsSelectionRequiredProperty = true ed è selezionato un unico elemento. Viene chiamato il metodo AddToSelection su un contenitore a selezione singola in cui CanSelectMultipleProperty = false ed è già selezionato un altro elemento.

InvalidOperationException

Quando viene eseguito uno dei tentativi seguenti:

Viene chiamato il metodo RemoveFromSelection su un contenitore a selezione singola in cui IsSelectionRequiredProperty = true e un elemento è già selezionato.
Viene chiamato il metodo RemoveFromSelection su un contenitore a selezione multipla in cui IsSelectionRequiredProperty = true ed è selezionato un unico elemento.
Viene chiamato il metodo AddToSelection su un contenitore a selezione singola in cui CanSelectMultipleProperty = false ed è già selezionato un altro elemento.