Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku podokno
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 obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku Podokno. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností a vzory ovládacích prvků.
Typ ovládacího prvku Podokno 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, ale nemůžou přecházet mezi položkami v různých podoknech. Ovládací prvky podokna tedy 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. Typ ovládacího prvku Podokno nevyžaduje žádnou konkrétní navigaci pomocí klávesnice.
Následující části definují požadovanou model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Podokno. Požadavky na model UI Automation platí pro všechny ovládací prvky seznamu, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, 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 model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Podokno | Podokno |
Požadované vlastnosti model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky podokna. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| AutomationIdProperty | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci. |
| BoundingRectangleProperty | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| NameProperty | Viz poznámky. | Hodnota této vlastnosti musí být vždy jasný, výstižný a výstižný název. |
| ClickablePointProperty | 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. |
| LabeledByProperty | 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. |
| ControlTypeProperty | Podokno | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "pane" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Podokno. |
| IsContentElementProperty | True | Ovládací prvky podokna jsou vždy zahrnuty v zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvky podokna jsou vždy zahrnuty v zobrazení ovládacího prvku stromu model UI Automation. |
| HelpTextProperty | "" | Text nápovědy pro ovládací prvky podokna by měl vysvětlit, proč účel rámečku a jak souvisí s jinými snímky. Popis je nezbytný, pokud účel a vztah rámců není jasné z hodnoty NameProperty. " |
| AccessKeyProperty | 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. |
Požadované vzory ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, které musí podporovat všechny ovládací prvky podokna. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| ITransformProvider | Závisí | Implementujte tento vzor ovládacího prvku, pokud lze ovládací prvek podokna přesunout, změnit jeho velikost nebo otočit na obrazovce. |
| IWindowProvider | Nikdy | Pokud potřebujete tento vzor ovládacího prvku implementovat, měl by být ovládací prvek založený na Window typu ovládacího prvku. |
| IDockProvider | Závisí | Implementujte tento vzor ovládacího prvku, pokud je možné ukotvit ovládací prvek podokna. |
| IScrollProvider | Závisí | Implementujte tento vzor ovládacího prvku, pokud lze ovládací prvek podokna posunout. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky podokna. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Podpora/hodnota | Notes |
|---|---|---|
| WindowClosedEvent | Nikdy | Nic |
| WindowOpenedEvent | Nikdy | Nic |
| AsyncContentLoadedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| HorizontallyScrollableProperty událost změněná vlastností. | Závisí | Nic |
| HorizontalScrollPercentProperty událost změněná vlastností. | Závisí | Nic |
| HorizontalViewSizeProperty událost změněná vlastností. | Závisí | Nic |
| VerticalScrollPercentProperty událost změněná vlastností. | Závisí | Nic |
| VerticallyScrollableProperty událost změněná vlastností. | Závisí | Nic |
| VerticalViewSizeProperty událost změněná vlastností. | Závisí | Nic |
| WindowVisualStateProperty událost změněná vlastností. | Nikdy | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
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.
| strom model UI Automation – zobrazení ovládacího prvku | strom model UI Automation – zobrazení obsahu |
|---|---|
|
-Podokně - Strom (vzor posouvání) -Treeitem - ... Podokně -Upravit - (Vzor posouvání) |