Podpora automatizace uživatelského rozhraní pro ovládací prvek podokna

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 obsahuje informace o podpoře automatizace uživatelského rozhraní pro typ ovládacího prvku Pane. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků.

Typ ovládacího prvku Pane se používá 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 specifickou navigaci pomocí klávesnice.

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 seznamu, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení 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í najdete v tématu Přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku	Zobrazení obsahu
Okno	Okno

Požadované vlastnosti automatizace uživatelského rozhraní

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 Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
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	Okno	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 okna.
IsContentElementProperty	Pravdivé	Ovládací prvky podokna jsou vždy zahrnuty v zobrazení obsahu stromu automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvky podokna jsou vždy součástí zobrazení ovládacích prvků v rámci stromu automatizace uživatelského rozhraní.
HelpTextProperty	""	Text nápovědy pro ovládací prvky podokna by měl vysvětlit účel rámečku a jak souvisí s ostatními rámečky. 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ů automatizace uživatelského rozhraní

Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky 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
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ádání, pokud lze ovládací prvek podokna posouvat.

Požadované události automatizace uživatelského rozhraní

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky podokna. 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í	Podpora/hodnota	Poznámky
WindowClosedEvent	Nikdy	Žádné
WindowOpenedEvent	Nikdy	Žádné
AsyncContentLoadedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
HorizontallyScrollableProperty událost změny vlastnosti.	Závisí	Žádné
HorizontalScrollPercentProperty událost změny vlastnosti.	Závisí	Žádné
HorizontalViewSizeProperty událost změny vlastnosti.	Závisí	Žádné
VerticalScrollPercentProperty událost změny vlastnosti.	Závisí	Žádné
VerticallyScrollableProperty událost změny vlastnosti.	Závisí	Žádné
VerticalViewSizeProperty událost změny vlastnosti.	Závisí	Žádné
WindowVisualStateProperty událost změny vlastnosti.	Nikdy	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Příklad typu ovládacího prvku podokna

Následující obrázek znázorňuje ovládací prvek implementující typ ovládacího prvku Podokno.

Strom automatizace uživatelského rozhraní – zobrazení ovládacího prvku	Strom automatizace uživatelského rozhraní – zobrazení obsahu
Okno Strom (vzor posouvání) TreeItem Okno Upravit (vzor posouvání)	-Panel - Strom (rolovací vzor) - TreeItem - ...Pane -Upravit - (Pattern posouvání)

Viz také

• Pane
• Přehled typů ovládacích prvků automatizace uživatelského rozhraní
• Přehled automatizace uživatelského rozhraní