Implementace vzoru ovládacích prvků ukotvení pro automatizaci uživatelského rozhraní
Poznámka:
Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma představuje pokyny a konvence pro implementaci IDockProvider, včetně informací o vlastnostech. Odkazy na další odkazy jsou uvedeny na konci tématu.
Vzor DockPattern ovládacího prvku se používá k zveřejnění vlastností ukotvení ovládacího prvku v dokovacím kontejneru. Dokovací kontejner je ovládací prvek, který umožňuje uspořádat podřízené prvky vodorovně a svisle vzhledem k sobě. Příklady ovládacích prvků, které tento vzor ovládacích prvků implementují, naleznete v tématu Mapování vzorů ovládacích prvků pro model UI Automation Klienti.
Příklad ukotvení ze sady Visual Studio, kde okno Zobrazení třídy je DockPosition.Right a Okno Seznam chyb je DockPosition.Bottom
Pokyny a konvence implementace
Při implementaci vzoru ovládacích prvků Dock si všimněte následujících pokynů a konvencí:
IDockProvider nezpřístupňuje žádné vlastnosti ukotveného kontejneru ani žádné vlastnosti ovládacích prvků, které jsou ukotveny vedle aktuálního ovládacího prvku v dokovacím kontejneru.
Ovládací prvky jsou ukotvené vzhledem k sobě na základě jejich aktuálního pořadí vykreslování; čím vyšší je umístění pořadí vykreslování, tím dál jsou umístěny od zadaného okraje dokovací nádoby.
Pokud změníte velikost kontejneru ukotvení, všechny ukotvené ovládací prvky v kontejneru se přemístí na stejný okraj, ke kterému byly původně ukotveny. Ukotvené ovládací prvky také změní velikost tak, aby vyplnily libovolné místo v kontejneru podle chování ukotvení jejich DockPosition. Pokud Top je například zadáno, levá a pravá strana ovládacího prvku se rozbalí a vyplní všechny dostupné místo. Pokud Fill je zadáno, všechny čtyři strany ovládacího prvku se rozbalí, aby vyplnily libovolné dostupné místo.
V systému s více monitory by se ovládací prvky měly ukotvit na levé nebo pravé straně aktuálního monitoru. Pokud to není možné, měly by se ukotvit na levou stranu levého monitoru nebo pravé strany monitoru úplně vpravo.
Požadované členy pro IDockProvider
Pro implementaci rozhraní IDockProvider jsou vyžadovány následující vlastnosti a metody.
| Požadované členy | Typ členu | Notes |
|---|---|---|
| DockPosition | Vlastnost | Nic |
| SetDockPosition | metoda | Nic |
Tento vzor ovládacího prvku nemá žádné přidružené události.
Výjimky
Poskytovatelé musí vyvolat následující výjimky.
| Typ výjimky | Podmínka |
|---|---|
| InvalidOperationException | SetDockPosition – Pokud ovládací prvek nemůže spustit požadovaný styl ukotvení. |
Viz také
- Přehled vzorů ovládacích prvků pro automatizaci uživatelského rozhraní
- Podpora vzorů ovládacích prvků u zprostředkovatele automatizace uživatelského rozhraní
- Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
- Přehled stromu automatizace uživatelského rozhraní
- Použití mezipaměti při automatizaci uživatelského rozhraní