Implementace vzoru pro ovládání transformací v 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 ITransformProvider, včetně informací o vlastnostech, metodách a událostech. Odkazy na další odkazy jsou uvedeny na konci tématu.

Vzor TransformPattern ovládacího prvku slouží k podpoře ovládacích prvků, které je možné přesouvat, měnit jejich velikost nebo otáčet v rámci dvojrozměrného prostoru. 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í.

Pokyny a konvence implementace

Při implementaci vzoru ovládacího prvku Transformace si všimněte následujících pokynů a konvencí:

• Podpora tohoto vzoru ovládacího prvku není omezena na objekty na ploše. Tento řídicí vzor musí být podporován také podřízenými objekty kontejneru, pokud lze podřízené objekty přesouvat, měnit jejich velikost nebo otáčet volně v rámci hranic kontejneru.

• Objekt nelze přesunout, změnit jeho velikost ani otočit tak, aby jeho výsledné umístění obrazovky bylo zcela mimo souřadnice kontejneru, a proto je nepřístupné pro klávesnici nebo myš (například když se okno nejvyšší úrovně přesune mimo obrazovku nebo podřízený objekt se přesune mimo hranice oblasti zobrazení kontejneru). V těchto případech je objekt umístěn co nejblíže požadovaným souřadnicím obrazovky s přepsanými horními nebo levými souřadnicemi, aby byl v rámci hranic kontejneru.

• U systémů s více monitory se objekt přesune, změní jeho velikost nebo otočí úplně mimo kombinované souřadnice obrazovky plochy, umístí se objekt na primární monitor co nejblíže požadovaným souřadnicům.

• Všechny parametry a hodnoty vlastností jsou absolutní a nezávislé na národním prostředí.

Požadované členy pro ITransformProvider

Pro implementaci ITransformProviderjsou vyžadovány následující vlastnosti a metody .

Požadované členy	Typ členu	Poznámky
CanMove	Vlastnictví	Žádné
CanResize	Vlastnictví	Žádné
CanRotate	Vlastnictví	Žádné
Move	Metoda	Žádné
Resize	Metoda	Žádné
Rotate	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	Move - Pokud je CanMoveProperty nepravdivé.
InvalidOperationException	Resize - Pokud je CanResizeProperty nepravdivé.
InvalidOperationException	Rotate - Pokud je CanRotateProperty nepravdivé.

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í