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
- Attributs de police
- Attributs de langue
- Attribut de lien
- Attributs de marge de page
- Attributs d’alignement du texte
- Attributs de couleur de texte
- Attributs de décoration de texte
- Attributs de style de texte
- Attributs d’interaction et de sélection
- Rubriques connexes
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 |
Attribut de lien
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 |
Rubriques connexes