Implementace vzoru ovládacích prvků Dock 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 automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

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é implementují tento vzor ovládacího prvku, naleznete v tématu mapování vzorů ovládacích prvků pro klienty automatizace uživatelského rozhraní.

Příklad ukotvení ze sady Visual Studio, kde okno Zobrazení třídy je na pozici vpravo a okno Seznam chyb je na pozici dole

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í prvku DockPosition. Pokud je například Top zadáno, levá a pravá strana ovládacího prvku se rozbalí a vyplní veškeré 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	Poznámky
DockPosition	Vlastnictví	Žádné
SetDockPosition	Metoda	Žádné

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 provést požadovaný styl ukotvení.

Viz také

• Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní
• Podpora vzorů ovládacích prvků v poskytovateli 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í ukládání do mezipaměti v automatizaci uživatelského rozhraní