Implementace vzoru ovládacích prvků transformace 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 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é tento vzor ovládacích prvků implementují, naleznete v tématu Mapování vzorů ovládacích prvků pro model UI Automation Klienti.
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 | Notes |
|---|---|---|
| CanMove | Vlastnost | Nic |
| CanResize | Vlastnost | Nic |
| CanRotate | Vlastnost | Nic |
| Move | metoda | Nic |
| Resize | metoda | Nic |
| Rotate | 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 | Move - Pokud je nepravda CanMoveProperty . |
| InvalidOperationException | Resize - Pokud je nepravda CanResizeProperty . |
| InvalidOperationException | Rotate - Pokud je nepravda CanRotateProperty . |
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í