Atributy textu automatizace uživatelského rozhraní
Toto téma popisuje, jak Microsoft UI Automation zveřejňuje vlastnosti formátu a stylu (atributy textu) textového obsahu a poskytuje seznam podporovaných atributů textu.
Zprostředkovatelé automatizace uživatelského rozhraní zpřístupňují textové atributy prostřednictvím GetAttributeValue a FindAttribute metod TextRange vzoru ovládacího prvku. Klientské aplikace používají metodu IUIAutomationTextRange::GetAttributeValue k načtení hodnoty konkrétního textového atributu pro rozsah textu. Klienti mohou použít metodu IUIAutomationTextRange::FindAttribute k vyhledání textového rozsahu textu, který má určitý atribut. Pokud se najde nějaký odpovídající text, metoda vytvoří novou oblast textu, která obsahuje odpovídající text.
Textové atributy v následujícím seznamu jsou podporovány vzorem ovládacího prvku TextRange. Názvy atributů jsou odvozeny od identifikátorů textových atributů automatizace uživatelského rozhraní. Například atribut AnimationStyle je identifikován klienty jako UIA_AnimationStyleAttributeId (definované v Uiautomationclient.h) a poskytovateli jako Text_AnimationStyle_Attribute_GUID (definované v Uiautomationcoreapi.h). Další informace o každém podporovaném textovém atributu naleznete v tématu Identifikátory atributů textu.
Poznámka
Některé uvedené atributy jsou podporované od Windows 8. Poznámky týkající se podpory verzí najdete v tématu Identifikátory atributů textu.
Toto téma obsahuje následující části:
- atributy poznámek
- atributy písma
- atributy jazyka
- atributu propojení
- atributy okrajů stránky
- atributy zarovnání textu
- atributy barvy textu
- atributy dekorace textu
- atributy stylu textu
- interakce a atributů výběru
- související témata
Atributy poznámek
Objekty poznámek a typy poznámek jsou k dispozici prostřednictvím následujících atributů.
| Atribut | Identifikátor |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Atributy písma
Název, velikost a váha písma je k dispozici prostřednictvím následujících atributů.
| Atribut | Identifikátor |
|---|---|
| FontName | UIA_FontNameAttributeId |
| fontSize | UIA_FontSizeAttributeId |
| FontWeight | UIA_FontWeightAttributeId |
Atributy jazyka
Informace o jazyce textu jsou k dispozici prostřednictvím následujících atributů.
| Atribut | Identifikátor |
|---|---|
| jazykové verze | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Atribut odkazu
Následující atribut poskytuje textový rozsah, který je cílem odkazu v dokumentu.
| Atribut | Identifikátor |
|---|---|
| propojení | UIA_LinkAttributeId |
Atributy okrajů stránky
Ohraničující obdélníky oblasti textu nezpřístupňují souřadnice textu na stránce. Zprostředkovatel ale může informace o okrajích stránky zveřejnit pomocí následujících textových atributů.
| Atribut | Identifikátor |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| Okraje | UIA_MarginTopAttributeId |
| marginTrailing | UIA_MarginTrailingAttributeId |
Atributy zarovnání textu
Informace o zarovnání textu, jako je odsazení, nastavení tabulátoru a vodorovné zarovnání, jsou k dispozici prostřednictvím následujících atributů.
| Atribut | Identifikátor |
|---|---|
| horizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| odsazeníFirstLine | UIA_IndentationFirstLineAttributeId |
| odsazení | UIA_IndentationLeadingAttributeId |
| odsazení zábradlí | UIA_IndentationTrailingAttributeId |
| karty | UIA_TabsAttributeId |
Atributy barvy textu
Barvy textu popředí a pozadí jsou k dispozici prostřednictvím následujících atributů textu. Obě barvy se zadají jako datový typ COLORREF.
| Atribut | Identifikátor |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Atributy dekorace textu
Textové dekorace zahrnují oblasti, jako jsou odrážky, podtržení a animace. Pokud text obsahuje úvodní odrážky nebo čísla, měl by být symbol nebo text použitý pro odrážku nebo číslo zahrnut do textového streamu, pokud je to možné.
Informace o textových dekoracích jsou k dispozici prostřednictvím následujících atributů.
| Atribut | Identifikátor |
|---|---|
| AnimationStyle | UIA_AnimationStyleAttributeId |
| BulletStyle | UIA_BulletStyleAttributeId |
| OutlineStyles | UIA_OutlineStylesAttributeId |
| overlineColor | UIA_OverlineColorAttributeId |
| OverlineStyle | UIA_OverlineStyleAttributeId |
| StrikethroughColor | UIA_StrikethroughColorAttributeId |
| StrikethroughStyle | UIA_StrikethroughStyleAttributeId |
| UnderlineColor | UIA_UnderlineColorAttributeId |
| podtržení – | UIA_UnderlineStyleAttributeId |
Atributy stylu textu
Informace o textových stylech jsou k dispozici, i když jsou následující atributy.
| Atribut | Identifikátor |
|---|---|
| CapStyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| IsItalic | UIA_IsItalicAttributeId |
| IsReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
Interakce a atributy výběru
Informace o aktuálním výběru textu v rozsahu a stavu fokusu jsou k dispozici, i když následující atributy.
| Atribut | Identifikátor |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| stříškové | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Související témata
-
koncepční