UI Automation Text Attributes

In dit onderwerp wordt beschreven hoe Microsoft UI Automation de opmaak- en stijleigenschappen (tekstkenmerken) van tekstuele inhoud beschikbaar maakt en een lijst met ondersteunde tekstkenmerken bevat.

UI Automation-providers maken tekstkenmerken beschikbaar via de GetAttributeValue en FindAttribute methoden van het TextRange-besturingspatroon. Clienttoepassingen gebruiken de methode IUIAutomationTextRange::GetAttributeValue om de waarde van een bepaald tekstkenmerk voor een tekstbereik op te halen. Clients kunnen de methode IUIAutomationTextRange::FindAttribute gebruiken om een tekstbereik te doorzoeken op tekst met een bepaald kenmerk. Als er overeenkomende tekst wordt gevonden, maakt de methode een nieuw tekstbereik dat de overeenkomende tekst bevat.

De tekstkenmerken in de volgende lijst worden ondersteund door het besturingselement TextRange. De kenmerknamen worden afgeleid van de id's van het UI Automation-tekstkenmerk. Het kenmerk AnimationStyle wordt bijvoorbeeld geïdentificeerd door clients als UIA_AnimationStyleAttributeId (gedefinieerd in Uiautomationclient.h) en door providers als Text_AnimationStyle_Attribute_GUID (gedefinieerd in Uiautomationcoreapi.h). Zie Text Attribute Identifiersvoor meer informatie over elk ondersteund tekstkenmerk.

Notitie

Sommige van de vermelde kenmerken worden ondersteund vanaf Windows 8. Zie Text Attribute Identifiers voor opmerkingen met betrekking tot versieondersteuning.

 

Dit onderwerp bevat de volgende secties:

• annotatiekenmerken
• lettertypekenmerken
• taalkenmerken
• kenmerkkoppeling
• paginamargekenmerken
• kenmerken voor tekstuitlijning
• tekstkleurkenmerken
• tekstversieringskenmerken
• kenmerken van tekststijl
• interactie- en selectiekenmerken
• Verwante onderwerpen

Aantekeningenkenmerken

Aantekeningenobjecten en aantekeningentypen zijn beschikbaar via de volgende kenmerken.

Attribuut	Id
AnnotationObjects	UIA_AnnotationObjectsAttributeId
AnnotationTypes	UIA_AnnotationTypesAttributeId

 

Lettertypekenmerken

De naam, grootte en dikte van een lettertype is beschikbaar via de volgende kenmerken.

Attribuut	Id
FontName-	UIA_FontNameAttributeId
Lettertypegrootte	UIA_FontSizeAttributeId
FontWeight-	UIA_FontWeightAttributeId

 

Taalkenmerken

Informatie over de taal van de tekst is beschikbaar via de volgende kenmerken.

Attribuut	Id
Cultuur	UIA_CultureAttributeId
TextFlowDirections	UIA_TextFlowDirectionsAttributeId

 

Kenmerk koppeling

Het volgende kenmerk bevat het tekstbereik dat het doel is van een koppeling in een document.

Attribuut	Id
koppelen	UIA_LinkAttributeId

 

Kenmerken van paginamarge

In de begrenzingsrechthoeken van een tekstbereik worden de coördinaten van de tekst op de pagina niet weergegeven. Een provider kan de paginamargegegevens echter beschikbaar maken met behulp van de volgende tekstkenmerken.

Attribuut	Id
MarginBottom-	UIA_MarginBottomAttributeId
MarginLeading-	UIA_MarginLeadingAttributeId
MarginTop-	UIA_MarginTopAttributeId
MarginTrailing-	UIA_MarginTrailingAttributeId

 

Kenmerken voor tekstuitlijning

Informatie over tekstuitlijning, zoals inspringing, tabinstellingen en horizontale uitlijning, is beschikbaar via de volgende kenmerken.

Attribuut	Id
HorizontalTextAlignment-	UIA_HorizontalTextAlignmentAttributeId
IndentationFirstLine-	UIA_IndentationFirstLineAttributeId
IndentationLeading-	UIA_IndentationLeadingAttributeId
inspringing	UIA_IndentationTrailingAttributeId
tabs	UIA_TabsAttributeId

 

Kenmerken van tekstkleur

De voorgrond- en achtergrondtekstkleuren zijn beschikbaar via de volgende tekstkenmerken. Beide kleuren worden opgegeven als een COLORREF gegevenstype.

Attribuut	Id
BackgroundColor-	UIA_BackgroundColorAttributeId
ForegroundColor-	UIA_ForegroundColorAttributeId

 

Kenmerken van tekstdecoratie

Tekstdecoraties zijn onder andere gebieden zoals opsommingstekens, onderstrepen en animaties. Als tekst voorloopstekens of nummers bevat, moet het symbool of de tekst die wordt gebruikt voor het opsommingsteken of nummer, indien van toepassing, worden opgenomen in de tekststroom.

Informatie over tekstdecoraties is beschikbaar via de volgende kenmerken.

Attribuut	Id
AnimationStyle-	UIA_AnimationStyleAttributeId
Opsommingstekenstijl	UIA_BulletStyleAttributeId
OutlineStyles	UIA_OutlineStylesAttributeId
OverlineColor-	UIA_OverlineColorAttributeId
OverlineStyle-	UIA_OverlineStyleAttributeId
StrikethroughColor-	UIA_StrikethroughColorAttributeId
StrikethroughStyle	UIA_StrikethroughStyleAttributeId
UnderlineColor-	UIA_UnderlineColorAttributeId
UnderlineStyle-	UIA_UnderlineStyleAttributeId

 

Kenmerken van tekststijl

Informatie over tekststijlen is beschikbaar via de volgende kenmerken.

Attribuut	Id
CapStyle-	UIA_CapStyleAttributeId
IsHidden-	UIA_IsHiddenAttributeId
IsItalic-	UIA_IsItalicAttributeId
IsReadOnly-	UIA_IsReadOnlyAttributeId
IsSuperscript-	UIA_IsSuperscriptAttributeId
IsSubscript-	UIA_IsSubscriptAttributeId

 

Interactie- en selectiekenmerken

Informatie over de huidige tekstselectie in het bereik en de focusstatus is beschikbaar via de volgende kenmerken.

Attribuut	Id
IsActive-	UIA_IsActiveAttributeId
SelectionActiveEnd-	UIA_SelectionActiveEndAttributeId
CaretPosition-	UIA_CaretPositionAttributeId
CaretBidiMode	UIA_CaretBidiModeAttributeId

 

Verwante onderwerpen

conceptuele

Over de van ui-automatiseringstekst en textrange-besturingspatronen

tekst- en tekstbereikpatronen

Werken met besturingselementen op basis van tekst