Sdílet prostřednictvím

Typ ovládacího prvku dokumentu

  • Článek

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní Společnosti Microsoft pro typ ovládacího prvku Document.

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í jenom jednoduchý řádek neformátovaného textu, můžou ovládací prvky dokumentu hostovat text, který je formátovaný a formátovaný.

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

 

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 dokumentu. 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. Dokument má kliknoutelný bod, který způsobí, že dokument jednoho z jeho prvků v kontejneru dokumentů bude mít fokus.
UIA_ControlTypePropertyId dokumentu
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek dokumentu je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek dokumentu 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. Hodnota této vlastnosti by měla být popiskem ovládacího prvku dokumentu. Obvykle se používá název dokumentu.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku Document. Výchozí hodnota je "document" pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Ovládací prvek dokumentu obvykle získá jeho název z názvu souboru, ze který se načte. To se často zobrazuje v názvu okna nebo rámečku.

 

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ů dokumentu. 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
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 podporovat vzor ovládacích prvků Scroll, pokud je obsah posouván.
ITextProvider Požadovaný Všechny ovládací prvky dokumentu musí podporovat vzor ovládacích prvků text.
IValueProvider Závisí I když klienti automatizace uživatelského rozhraní můžou k získání textových informací o dokumentu použít IUIAutomationTextPattern, potřebují k nastavení vnitřní hodnoty vzor hodnota. Jednoduché zadávání textu je možné pouze prostřednictvím vzoru ovládacího prvku Hodnota.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky dokumentu 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_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_StructureChangedEventId
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_Selection_InvalidatedEventId Pokud ovládací prvek podporuje vzor ovládacího prvku Výběr, musí tuto událost podporovat.
UIA_Text_TextSelectionChangedEventId
UIA_Text_TextChangedEventId
UIA_ValueValuePropertyId událost změny vlastnosti. Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat.

 

koncepční

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

Přehled automatizace uživatelského rozhraní