Implementera UI Automation MultipleView-kontrollmönstret
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller riktlinjer och konventioner för att implementera IMultipleViewProvider, inklusive information om händelser och egenskaper. Länkar till ytterligare referenser visas i slutet av ämnet.
Kontrollmönstret MultipleViewPattern används för att stödja kontroller som tillhandahåller och kan växla mellan flera representationer av samma uppsättning information eller underordnade kontroller.
Exempel på kontroller som kan visa flera vyer är listvyn (som kan visa innehållet som miniatyrbilder, paneler, ikoner eller information), Microsoft Excel-diagram (cirkel, linje, stapel, cellvärde med en formel), Microsoft Word-dokument (normal, Webblayout, utskriftslayout, läslayout, disposition), Microsoft Outlook-kalender (år, månad, vecka, dag) och Microsoft Windows mediespelare skinn. De vyer som stöds bestäms av kontrollutvecklaren och är specifika för varje kontroll.
Riktlinjer och konventioner för implementering
När du implementerar kontrollmönstret För flera vyer bör du tänka på följande riktlinjer och konventioner:
IMultipleViewProvider bör också implementeras på en container som hanterar den aktuella vyn om den skiljer sig från en kontroll som tillhandahåller den aktuella vyn. Utforskaren innehåller till exempel en listkontroll för det aktuella mappinnehållet medan vyn för kontrollen hanteras från Windows Explorer-programmet.
En kontroll som kan sortera innehållet anses inte ha stöd för flera vyer.
Samlingen med vyer måste vara identisk mellan instanser.
Visningsnamn måste vara lämpliga för användning i text till tal, punktskrift och andra program som kan läsas av människor.
Nödvändiga medlemmar för IMultipleViewProvider
Följande egenskaper och metoder krävs för att implementera IMultipleViewProvider.
| Obligatoriska medlemmar | Medlemstyp | Kommentar |
|---|---|---|
| CurrentView | Property | Ingen |
| GetSupportedViews | Metod | Ingen |
| GetViewName | Metod | Ingen |
| SetCurrentView | Metod | Ingen |
Det finns inga händelser som är associerade med det här kontrollmönstret.
Undantag
Providern måste utlösa följande undantag.
| Undantagstyp | Villkor |
|---|---|
| ArgumentException | När antingen SetCurrentView eller GetViewName anropas med en parameter som inte är medlem i samlingen vyer som stöds. |