Typ ovládacího prvku Text
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é struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
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 |
---|---|
|
|
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. |
Související témata