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
- Attributs de police
- Attributs de langage
- Attribut de lien
- Attributs de marge de page
- Attributs d’alignement de 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 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 |
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 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 |