Implementazione del pattern di controllo SelectionItem di automazione interfaccia utente

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

Questo argomento presenta linee guida e convenzioni per l'implementazione di ISelectionItemProvider, incluse informazioni su proprietà, metodi ed eventi. I collegamenti a riferimenti aggiuntivi sono elencati alla fine della panoramica.

Il pattern di controllo SelectionItemPattern viene usato per supportare i controlli che fungono da singoli elementi figlio che possono essere selezionati dei controlli di contenitore che implementano ISelectionProvider. Per esempi di controlli che implementano il pattern di controllo SelectionItem, vedere Mappatura dei modelli di controllo per i client di automazione dell'interfaccia utente.

Linee guida e convenzioni di implementazione

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

• I controlli a selezione singola che gestiscono i controlli figlio che implementano IRawElementProviderFragmentRoot, come il dispositivo di scorrimento della risoluzione dello schermo nella finestra di dialogo Proprietà di visualizzazione , devono implementare ISelectionProvider e i relativi elementi figlio devono implementare sia IRawElementProviderFragment che ISelectionItemProvider.

Membri obbligatori per ISelectionItemProvider

Per implementare ISelectionItemProvidersono necessari i metodi e gli eventi seguenti.

Membri obbligatori	Tipo di membro	Note
IsSelected	Proprietà	Nessuno
SelectionContainer	Proprietà	Nessuno
AddToSelection	Metodo	Nessuno
RemoveFromSelection	Metodo	Nessuno
Select	Metodo	Nessuno
ElementSelectedEvent	Evento	Generato quando una modifica della selezione comporta un singolo elemento selezionato.
ElementAddedToSelectionEvent	Evento	Generato quando un elemento viene aggiunto a un contenitore a selezione multipla.
ElementRemovedFromSelectionEvent	Evento	Generato quando un elemento viene rimosso da un contenitore a selezione multipla.
InvalidatedEvent	Evento	Generato quando una selezione in un contenitore è cambiata in modo significativo e richiede l'invio di più eventi ElementSelectedEvent e ElementRemovedFromSelectionEvent di quanti ne consenta la costante InvalidateLimit.

• Se un'operazione Select, AddToSelectiono RemoveFromSelection genera un singolo elemento selezionato, generare ElementSelectedEvent; in caso contrario, generare ElementAddedToSelectionEvent o ElementRemovedFromSelectionEvent in base alle esigenze.

Eccezioni

I provider devono sollevare le eccezioni seguenti.

Tipo di eccezione

Condizione

InvalidOperationException

Quando si tenta uno dei seguenti tentativi: - RemoveFromSelection viene chiamato in un contenitore a selezione singola in cui IsSelectionRequiredProperty = true e un elemento è già selezionato. - RemoveFromSelection viene chiamato in un contenitore a selezione multipla in cui IsSelectionRequiredProperty = true e viene selezionato un solo elemento. - AddToSelection viene chiamato in un contenitore a selezione singola in cui CanSelectMultipleProperty = false e un altro elemento è già selezionato.

Vedere anche

• Panoramica modelli di controllo di automazione interfaccia utente
• Supportare i Pattern di Controllo in un Provider di Automazione dell'Interfaccia Utente
• Modelli di Controllo di Automazione per l'Interfaccia Utente dei Client
• Implementazione del pattern di controllo di selezione dell'automazione UI
• Panoramica dell'albero di automazione UI
• Usare il caching nell'automazione dell'interfaccia utente
• Esempio di provider di frammenti