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 d’attributs de texte pris en charge.

Les fournisseurs UI Automation exposent des attributs de texte via les méthodesGetAttributeValueet 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 un texte contenant un attribut particulier. Si un texte correspondant est trouvé, la méthode crée une 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’attributs 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éfinis dans Uiautomationcoreapi.h). Pour plus d’informations sur chaque attribut de texte pris en charge, consultez identificateurs d’attributs de texte.

Note

Certains attributs répertoriés sont pris en charge à partir de Windows 8. Consultez identificateurs d’attributs de texte pour obtenir des notes concernant la prise en charge des versions.

 

Cette rubrique contient les sections suivantes :

Attributs d’annotation

Les objets d’annotation et les types d’annotations 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
Lier 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
onglets 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 sous-titres et des animations. Si le texte inclut des puces ou des nombres de début, 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.

Des 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
SoulignéColor UIA_UnderlineColorAttributeId
UnderlineStyle UIA_UnderlineStyleAttributeId

 

Attributs de style de texte

Les informations sur les styles de texte sont disponibles bien que les attributs suivants soient disponibles.

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 bien que les attributs suivants soient disponibles.

Attribut Identificateur
IsActive UIA_IsActiveAttributeId
SelectionActiveEnd UIA_SelectionActiveEndAttributeId
CaretPosition UIA_CaretPositionAttributeId
CaretBidiMode UIA_CaretBidiModeAttributeId

 

conceptuelle

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

modèles de contrôle Text et TextRange

utiliser des contrôles textuels

 

 

  • Last updated on