Implementera UI Automation Dock Control Pattern
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 IDockProvider, inklusive information om egenskaper. Länkar till ytterligare referenser visas i slutet av ämnet.
Kontrollmönstret DockPattern används för att exponera dockningsegenskaperna för en kontroll i en dockningscontainer. En dockningscontainer är en kontroll som gör att du kan ordna underordnade element vågrätt och lodrätt i förhållande till varandra. Exempel på kontroller som implementerar det här kontrollmönstret finns i Kontrollmönstermappning för UI Automation-klienter.
Dockningsexempel från Visual Studio där fönstret "Klassvy" är DockPosition.Right och fönstret "Fellista" är DockPosition.Bottom
Riktlinjer och konventioner för implementering
Observera följande riktlinjer och konventioner när du implementerar Dock-kontrollmönstret:
IDockProvider exponerar inte några egenskaper för dockningscontainern eller några egenskaper för kontroller som dockas intill den aktuella kontrollen i dockningscontainern.
Kontrollerna dockas i förhållande till varandra baserat på deras aktuella z-ordning. ju högre z-orderplacering, desto längre placeras de från den angivna kanten av dockningscontainern.
Om dockningscontainern ändras flyttas alla dockade kontroller i containern till samma kant som de ursprungligen dockades till. De dockade kontrollerna ändrar också storlek för att fylla allt utrymme i containern enligt dockningsbeteendet för deras DockPosition. Om Top det till exempel anges expanderas kontrollens vänstra och högra sidor för att fylla allt tillgängligt utrymme. Om Fill anges expanderar alla fyra sidorna av kontrollen för att fylla tillgängligt utrymme.
I ett system med flera övervakare ska kontrollerna dockas till vänster eller höger om den aktuella övervakaren. Om det inte är möjligt bör de docka till vänster i den vänstra övervakaren eller höger sida av den högra övervakaren.
Obligatoriska medlemmar för IDockProvider
Följande egenskaper och metoder krävs för att implementera IDockProvider-gränssnittet.
| Obligatoriska medlemmar | Medlemstyp | Kommentar |
|---|---|---|
| DockPosition | Property | Ingen |
| SetDockPosition | Metod | Ingen |
Det här kontrollmönstret har inga associerade händelser.
Undantag
Leverantörer måste utlösa följande undantag.
| Undantagstyp | Villkor |
|---|---|
| InvalidOperationException | SetDockPosition – När en kontroll inte kan köra det begärda dockningsformatet. |