Attributs de texte UI Automation

Cette rubrique décrit comment Microsoft UI Automation expose les propriétés de mise en forme 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 par le biais des 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 dans une plage de texte un texte ayant un attribut particulier. 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 en tant que UIA _ AnimationStyleAttributeId (défini dans UIAutomationClient. h) et par les fournisseurs comme texte _ _ _ GUID d’attribut AnimationStyle (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 des attributs répertoriés sont pris en charge à partir de Windows 8. Consultez identificateurs d’attribut de texte pour les notes relatives à 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 par le biais des 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 par le biais des attributs suivants.

Attribut Identificateur
FontName UIA _ FontNameAttributeId
FontSize UIA _ FontSizeAttributeId
FontWeight UIA _ FontWeightAttributeId

Attributs de langage

Les informations relatives à la langue du texte sont disponibles par le biais des attributs suivants.

Attribut Identificateur
Culturel 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 sur les marges 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 de texte

Les informations relatives à l’alignement du texte, telles que la mise en retrait, les paramètres d’onglet et l’alignement horizontal, sont disponibles par le biais des 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 les puces, le soulignement et les 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 par le biais des 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
UnderlineColor 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

Les informations relatives à la sélection de texte en cours dans la plage et l’état du focus sont disponibles via les attributs suivants.

Attribut Identificateur
IsActive UIA _ IsActiveAttributeId
SelectionActiveEnd UIA _ SelectionActiveEndAttributeId
CaretPosition UIA _ CaretPositionAttributeId
CaretBidiMode UIA _ CaretBidiModeAttributeId

Conceptuel

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

Modèles de contrôle Text et TextRange

Utilisation de contrôles textuels