Sdílet prostřednictvím

Typ ovládacího prvku Text

  • Článek

Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Text.

Textový ovládací prvek je základní položka uživatelského rozhraní, která představuje část textu na obrazovce.

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 Text. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky stromu, 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á textových ovládacích prvků 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
  • Text
  • Text (pokud obsah)

 

Textový ovládací prvek lze použít samostatně jako popisek nebo jako statický text ve formuláři. Může být také obsažen ve struktuře jedné z následujících položek:

Textové ovládací prvky se nemusí zobrazovat v zobrazení obsahu stromu Automatizace uživatelského rozhraní, protože text se často zobrazuje prostřednictvím vlastnosti Název jiného ovládacího prvku. Například text použitý k označení ovládacího prvku pole se seznamem je vystaven prostřednictvím vlastnosti Název ovládacího prvku. Vzhledem k tomu, že ovládací prvek pole se seznamem je v zobrazení obsahu stromu Automatizace uživatelského rozhraní, nemusí tam být ovládací prvek textu. Ovládací prvky textu můžou mít v zobrazení obsahu podřízené prvky, pokud existuje vložený objekt, například hypertextový odkaz.

Relevantní vlastnosti

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro textové ovládací prvky. 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. Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod.
UIA_ControlTypePropertyId textové
UIA_IsContentElementPropertyId Závisí Textový ovládací prvek je obsah, pokud obsahuje informace, které nejsou vystaveny ve vlastnosti Název jiného ovládacího prvku.
UIA_IsControlElementPropertyId PRAVDIVÝ Textový ovládací prvek musí být vždy ovládací prvek.
UIA_IsKeyboardFocusablePropertyId Viz poznámky. Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
UIA_LabeledByPropertyId NULA Textové ovládací prvky nemají statický textový popisek.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku Text. Výchozí hodnota je text pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Název textového ovládacího prvku může být text, který se zobrazí. Pokud ale ovládací prvek podporuje také vzor textu a text je rozsáhlý, nepoužívejte jako hodnotu Název celý text. Místo toho zadejte hodnotu Název, která je kratší, odvozená od jiných vlastností ovládacího prvku.

 

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ů textu. 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
IGridItemProvider Závisí Pokud je ovládací prvek textu obsažený v ovládacím prvku tabulky, musí být podporován vzor ovládacích prvků GridItem.
ITableItemProvider Závisí Pokud je textový ovládací prvek obsažený v ovládacím prvku tabulky, musí být podporován vzor ovládacích prvků TableItem.
ITextProvider Závisí Text by měl podporovat vzor ovládacích prvků Text pro lepší přístupnost; není však vyžadováno. Vzor ovládacího prvku Text je užitečný, pokud má text formátovaný styl a atributy (například barvu, tučné písmo a kurzívu).
IValueProvider Nikdy Textový ovládací prvek nikdy nepodporuje vzor ovládacích prvků hodnota. Pokud je text upravitelný, jedná se o typ ovládacího prvku Upravit.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které textové ovládací prvky 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_NamePropertyId událost změněnou vlastností.
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId Pokud ovládací prvek podporuje vzor ovládacího prvku Text, 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í