Implementazione del pattern di controllo MultipleView di automazione interfaccia utente

  • Articolo

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono presentate le linee guida e le convenzioni per l'implementazione di IMultipleViewProvider, incluse le informazioni relative a eventi e proprietà. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il pattern di controllo MultipleViewPattern viene usato per supportare i controlli che implementano più rappresentazioni dello stesso set di informazioni o controlli figlio e che sono in grado di scorrere tali rappresentazioni.

Esempi di controlli che possono presentare più visualizzazioni includono la visualizzazione elenco (che può visualizzarne il contenuto sotto forma di anteprime, riquadri, icone o dettagli), grafici di Microsoft Excel (a torta, a linee, a barre, valore di cella con una formula), documenti di Microsoft Word (normale, layout Web, layout di stampa, layout lettura, struttura), calendario di Microsoft Outlook (anno, mese, settimana, giorno) e interfacce di Microsoft Windows Media Player. Le visualizzazioni supportate sono determinate dallo sviluppatore del controllo e sono specifiche di ogni controllo.

Linee guida e convenzioni di implementazione

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

  • Anche l'interfacciaIMultipleViewProvider deve essere implementata in un contenitore che gestisce la visualizzazione corrente se è diversa da un controllo che fornisce la visualizzazione corrente. Ad esempio, Esplora risorse contiene un controllo elenco per il contenuto della cartella corrente, mentre la visualizzazione per il controllo viene gestita dall'applicazione Esplora risorse.

  • Un controllo in grado di ordinare il relativo contenuto non supporta più visualizzazioni.

  • La raccolta di visualizzazioni deve essere identica tra istanze.

  • I nomi delle visualizzazioni devono essere adatti all'uso nelle applicazioni di sintesi vocale o nelle altre applicazioni per la lettura in Braille e altri metodi di lettura.

Membri obbligatori per IMultipleViewProvider

Le proprietà e i metodi seguenti sono obbligatori per l'implementazione di IMultipleViewProvider.

Membri obbligatori Tipo di membro Note
CurrentView Proprietà None
GetSupportedViews metodo None
GetViewName metodo None
SetCurrentView metodo None

Non sono presenti eventi associati a questo pattern di controllo.

Eccezioni

I provider devono generare le eccezioni seguenti.

Tipo di eccezione Condizione
ArgumentException Viene eseguita una chiamata a SetCurrentView o GetViewName con un parametro che non è un membro della raccolta delle visualizzazioni supportate.

Vedi anche