Partager via


attributs de texte UI Automation

Cette rubrique décrit comment Microsoft UI Automation expose les propriétés de format et de style (attributs de texte) du contenu textuel, et fournit une liste des attributs de texte pris en charge.

UI Automation fournisseurs exposent des attributs de texte via les méthodes GetAttributeValue et FindAttribute du modèle de contrôle TextRange. Les applications clientes utilisent la méthode IUIAutomationTextRange::GetAttributeValue pour récupérer la valeur d’un attribut de texte particulier pour une plage de texte. Les clients peuvent utiliser la méthode IUIAutomationTextRange::FindAttribute pour rechercher du texte qui a un attribut particulier dans une plage de texte. Si un texte correspondant est trouvé, la méthode crée une nouvelle plage de texte qui contient le texte correspondant.

Les attributs de texte de la liste suivante sont pris en charge par le modèle de contrôle TextRange . Les noms d’attributs sont dérivés des identificateurs d’attribut de texte UI Automation. Par exemple, l’attribut AnimationStyle est identifié par les clients comme UIA_AnimationStyleAttributeId (défini dans Uiautomationclient.h) et par les fournisseurs comme Text_AnimationStyle_Attribute_GUID (défini dans Uiautomationcoreapi.h). Pour plus d’informations sur chaque attribut de texte pris en charge, consultez Identificateurs d’attribut de texte.

Notes

Certains attributs répertoriés sont pris en charge à partir de Windows 8. Consultez Identificateurs d’attribut de texte pour obtenir des remarques sur la prise en charge des versions.

 

Cette rubrique contient les sections suivantes :

Attributs d'annotation

Les objets d’annotation et les types d’annotation sont disponibles via les attributs suivants.

Attribut Identificateur
AnnotationObjects UIA_AnnotationObjectsAttributeId
AnnotationTypes UIA_AnnotationTypesAttributeId

 

Attributs de police

Le nom, la taille et le poids d’une police sont disponibles via les attributs suivants.

Attribut Identificateur
FontName UIA_FontNameAttributeId
FontSize UIA_FontSizeAttributeId
FontWeight UIA_FontWeightAttributeId

 

Attributs de langue

Des informations sur la langue du texte sont disponibles via les attributs suivants.

Attribut Identificateur
Culture UIA_CultureAttributeId
TextFlowDirections UIA_TextFlowDirectionsAttributeId

 

L’attribut suivant fournit la plage de texte qui est la cible d’un lien dans un document.

Attribut Identificateur
Lien UIA_LinkAttributeId

 

Attributs de marge de page

Les rectangles englobants d’une plage de texte n’exposent pas les coordonnées du texte dans la page. Toutefois, un fournisseur peut exposer les informations de marge de page à l’aide des attributs de texte suivants.

Attribut Identificateur
MarginBottom UIA_MarginBottomAttributeId
MarginLeading UIA_MarginLeadingAttributeId
MarginTop UIA_MarginTopAttributeId
MarginTrailing UIA_MarginTrailingAttributeId

 

Attributs d’alignement du texte

Des informations sur l’alignement du texte, telles que la mise en retrait, les paramètres de tabulation et l’alignement horizontal, sont disponibles via les attributs suivants.

Attribut Identificateur
HorizontalTextAlignment UIA_HorizontalTextAlignmentAttributeId
IndentationFirstLine UIA_IndentationFirstLineAttributeId
IndentationLeading UIA_IndentationLeadingAttributeId
IndentationTrailing UIA_IndentationTrailingAttributeId
Tabulations UIA_TabsAttributeId

 

Attributs de couleur de texte

Les couleurs de texte de premier plan et d’arrière-plan sont disponibles via les attributs de texte suivants. Les deux couleurs sont spécifiées en tant que type de données COLORREF .

Attribut Identificateur
BackgroundColor UIA_BackgroundColorAttributeId
ForegroundColor UIA_ForegroundColorAttributeId

 

Attributs de décoration de texte

Les décorations de texte incluent des zones telles que des puces, des accents et des animations. Si le texte inclut des puces ou des nombres de débuts, le symbole ou le texte utilisé pour la puce ou le numéro doit être inclus dans le flux de texte, le cas échéant.

Les informations sur les décorations de texte sont disponibles via les attributs suivants.

Attribut Identificateur
AnimationStyle UIA_AnimationStyleAttributeId
BulletStyle UIA_BulletStyleAttributeId
OutlineStyles UIA_OutlineStylesAttributeId
OverlineColor UIA_OverlineColorAttributeId
OverlineStyle UIA_OverlineStyleAttributeId
StrikethroughColor UIA_StrikethroughColorAttributeId
StrikethroughStyle UIA_StrikethroughStyleAttributeId
SoulignementColor UIA_UnderlineColorAttributeId
UnderlineStyle UIA_UnderlineStyleAttributeId

 

Attributs de style de texte

Des informations sur les styles de texte sont disponibles via les attributs suivants.

Attribut Identificateur
CapStyle UIA_CapStyleAttributeId
IsHidden UIA_IsHiddenAttributeId
IsItalic UIA_IsItalicAttributeId
IsReadOnly UIA_IsReadOnlyAttributeId
IsSuperscript UIA_IsSuperscriptAttributeId
IsSubscript UIA_IsSubscriptAttributeId

 

Attributs d’interaction et de sélection

Des informations sur la sélection de texte actuelle dans la plage et l’état du focus sont disponibles dans les attributs suivants.

Attribut Identificateur
IsActive UIA_IsActiveAttributeId
SelectionActiveEnd UIA_SelectionActiveEndAttributeId
CaretPosition UIA_CaretPositionAttributeId
CaretBidiMode UIA_CaretBidiModeAttributeId

 

Conceptuel

À propos des modèles de contrôle Text et TextRange UI Automation

Modèles de contrôle Text et TextRange

Utilisation de contrôles textuels