Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku dokumentu

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 Dokument. 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ů.

Ovládací prvky dokumentu umožňují uživateli zobrazit více stránek textu a manipulovat s nimi. Na rozdíl od ovládacích prvků pro úpravy, které podporují pouze jednoduchý řádek neformátovaného textu, dokumentové ovládací prvky mohou obsahovat text, který je bohatě stylizovaný a upravený.

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 Dokument. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky dokumentu, 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ů dokumentu, 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
Dokument -Liší se	Dokument -Liší se

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 dokumentu. 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.
ClickablePointProperty	Viz poznámky.	Dokument má kliknoutelný bod, který způsobí, že dokument jednoho z jeho prvků v kontejneru dokumentů bude mít fokus.
ControlTypeProperty	Dokument	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
IsContentElementProperty	Pravdivé	Ovládací prvek dokumentu je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvek dokumentu je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
LabeledByProperty	Viz poznámky.	Hodnota této vlastnosti by měla být popiskem ovládacího prvku dokumentu. Obvykle se používá název dokumentu.
LocalizedControlTypeProperty	"dokument"	Lokalizovaný řetězec odpovídající typu ovládacího prvku Dokument.
NameProperty	Viz poznámky.	Ovládací prvek dokumentu obvykle získává jeho názvy z názvu souboru, ze který je načten. To se často zobrazuje v názvu okna nebo rámečku.

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é jsou potřeba k podpoře ovládacích prvků dokumentu. Další informace o vzorech ovládacích prvků naleznete v tématu Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vzor ovládacího prvku	Podpora	Poznámky
IScrollProvider	Závisí	Ovládací prvek dokumentu může být větší než toto rozpětí oblasti zobrazení. Ovládací prvek by měl mít podporu posuvného vzoru, pokud je obsah posuvný.
ITextProvider	Povinné	Ovládací prvek dokumentu může být větší než toto rozpětí oblasti zobrazení. Ovládací prvek by měl mít podporu posuvného vzoru, pokud je obsah posuvný.
IValueProvider	Nikdy	Ovládací prvek dokumentu nepodporuje tento vzor ovládacího prvku, protože obsah ovládacího prvku často pokrývá více než jednu stránku. Klienti automatizace uživatelského rozhraní by měli použít TextPattern k získání textových informací o dokumentu.

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 dokumentu. Další informace o událostech naleznete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
AutomationFocusChangedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
HorizontallyScrollableProperty událost změny vlastnosti.	Povinné	Žádné
HorizontalScrollPercentProperty událost změny vlastnosti.	Povinné	Žádné
HorizontalViewSizeProperty událost změny vlastnosti.	Povinné	Žádné
VerticalScrollPercentProperty událost změny vlastnosti.	Povinné	Žádné
VerticallyScrollableProperty událost změny vlastnosti.	Povinné	Žádné
VerticalViewSizeProperty událost změny vlastnosti.	Povinné	Žádné
InvalidatedEvent	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Výběr, musí tuto událost podporovat.
TextSelectionChangedEvent	Povinné	Žádné
TextChangedEvent	Povinné	Žádné
ValueProperty událost změny vlastnosti.	Nikdy	Žádné

Viz také

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