Typ ovládacího prvku podokna
Toto téma obsahuje informace o podpoře služby Microsoft UI Automation pro typ ovládacího prvku podokno.
Typ ovládacího prvku podokno je určen pro potenciálně posuvné oblasti, které mají různorodý obsah. Slouží k reprezentaci objektu v rámci rámečku nebo okna dokumentu. Uživatelé můžou přecházet mezi ovládacími prvky podokna a obsahem aktuálního podokna. Ovládací prvky podokna představují úroveň seskupení nižší než okna nebo dokumenty, ale nad jednotlivými ovládacími prvky. Uživatel přechází mezi podokny stisknutím kláves TAB, F6 nebo CTRL+TAB v závislosti na kontextu.
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 podokno. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky podokna, 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í
- Příklad typu ovládacího prvku podokna
- 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ů podokna 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 |
|---|---|
|
|
Ovládací prvek podokna se vždy zobrazí v zobrazení ovládacího prvku a obsahu. Nezpřístupňujte objekt rozložení jako podokno v ovládacím prvku nebo zobrazení obsahu, pokud se objekt používá pouze pro vizuální prezentaci.
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 podokna. 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_AccessKeyPropertyId | Viz poznámky. | Pokud se konkrétní kombinace kláves zaměřuje na podokno, měly by být tyto informace zpřístupněny prostřednictvím této vlastnosti. |
| 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. | Tato vlastnost zveřejňuje klikatelný bod ovládacího prvku podokna, který způsobí, že se podokno při kliknutí zaostřelo. |
| UIA_ControlTypePropertyId | podokna | |
| UIA_HelpTextPropertyId | Viz poznámky. | Text nápovědy pro ovládací prvky podokna by měl vysvětlit účel rámečku a jeho vztah k jiným snímkům. Popis je nezbytný, pokud účel a vztah rámců není jasné z hodnoty UIA_NamePropertyId vlastnost. |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Ovládací prvek podokna je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek podokna 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 | Viz poznámky. | Ovládací prvky podokna obvykle nemají statický popisek. Pokud je popisek statického textu, měl by být zpřístupněn prostřednictvím této vlastnosti. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku podokno. Výchozí hodnota je "pane" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Hodnota této vlastnosti musí být vždy jasný, výstižný a výstižný název. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které jsou potřeba k podpoře ovládacích prvků podokna. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| IDockProvider | Závisí | Implementujte vzor ovládacího prvku Dock, pokud je možné ovládací prvek podokna ukotvit. |
| IScrollProvider | Závisí | Implementujte vzor ovládacích prvků Scroll, pokud je možné ovládací prvek podokna posunout. |
| ITransformProvider | Závisí | Implementujte vzor ovládacího prvku Transformace, pokud je možné ovládací prvek podokna přesunout, změnit jeho velikost nebo otočit na obrazovce. |
| IWindowProvider | Nikdy | Pokud prvek potřebuje implementovat vzor ovládacích prvků Okno, měl by být ovládací prvek založen na typu ovládacího prvku Window. |
Požadované události
Následující tabulka obsahuje seznam událostí automatizace uživatelského rozhraní, které ovládací prvky podokna vyžadují pro podporu. 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_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| 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 |
Příklad typu ovládacího prvku podokna
Následující obrázek znázorňuje ovládací prvek, který implementuje typ ovládacího prvku podokno.
ovládacího prvku podokna
| Strom automatizace uživatelského rozhraní – zobrazení ovládacího prvku | Strom automatizace uživatelského rozhraní – zobrazení obsahu |
|---|---|
|
|
Související témata