Typ ovládacího prvku okna
Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní Microsoftu pro typ ovládacího prvku okna.
Ovládací prvek okna se skládá z rámečku okna, který obsahuje podřízené objekty, jako je záhlaví, klient a další objekty.
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Window. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky oken, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků oken a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky okna. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Ovládací prvek okna musí mít kliknutelný bod, který způsobí, že okno bude vybráno nebo nevybrané. |
| UIA_ControlTypePropertyId | okna | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Ovládací prvek okna je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek okna je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| UIA_LabeledByPropertyId | NULA | Ovládací prvky okna nemají statický popisek okna. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Window. Výchozí hodnota je "window" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Ovládací prvek okna vždy obsahuje primární prvek okna, který souvisí s tím, co by uživatel přidružil jako sémantický identifikátor položky. |
Požadované vzory ovládacích prvků
V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které musí ovládací prvky oken podporovat. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Poznámky |
|---|---|---|
| IDockProvider | Podmíněný | Ovládací prvek Dock musí být podporován, pokud lze okno ukotvit. |
| ITransformProvider | Požadovaný | Vzor ovládacího prvku Transformace umožňuje přesunutí, změnu velikosti nebo otočení okna na obrazovce. (Nevztahuje se na aplikace pro Windows Store.) |
| IWindowProvider | Požadovaný | Vzor ovládacího prvku Window umožňuje konkrétní operace pro okno. |
Požadované události
V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které okno ovládací prvky musí podporovat. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_LayoutInvalidatedEventId | |
| UIA_NamePropertyId událost změněnou vlastností. | |
| UIA_ScrollHorizontallyScrollablePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollHorizontalScrollPercentPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollHorizontalViewSizePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollVerticallyScrollablePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollVerticalScrollPercentPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollVerticalViewSizePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | |
| UIA_Window_WindowOpenedEventId | |
| UIA_WindowWindowVisualStatePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje WindowVisualState vlastnost Window vzoru ovládacího prvku, musí být tato událost podporována. |
Související témata