Benutzeroberflächenautomatisierungs-Textattribute
In diesem Thema wird beschrieben, wie die Microsoft-Benutzeroberflächenautomatisierung die Format- und Formateigenschaften (Textattribute) von Textinhalten verfügbar macht und eine Liste der unterstützten Textattribute bereitstellt.
Benutzeroberflächenautomatisierungs-Anbieter machen Textattribute über die GetAttributeValue- und FindAttribute- Methoden des TextRange Steuerelementmusters verfügbar. Clientanwendungen verwenden die IUIAutomationTextRange::GetAttributeValue Methode, um den Wert eines bestimmten Textattributs für einen Textbereich abzurufen. Clients können die IUIAutomationTextRange::FindAttribute Methode verwenden, um einen Textbereich nach Text zu durchsuchen, der ein bestimmtes Attribut aufweist. Wenn übereinstimmenden Text gefunden wird, erstellt die Methode einen neuen Textbereich, der den übereinstimmenden Text enthält.
Die Textattribute in der folgenden Liste werden vom TextRange Steuerelementmusters unterstützt. Die Attributnamen werden von den Bezeichnern des Benutzeroberflächenautomatisierungs-Textattributes abgeleitet. Beispielsweise wird das AnimationStyle-attribut von Clients als UIA_AnimationStyleAttributeId (definiert in Uiautomationclient.h) und von Anbietern als Text_AnimationStyle_Attribute_GUID (definiert in Uiautomationcoreapi.h) identifiziert. Weitere Informationen zu den einzelnen unterstützten Textattributen finden Sie unter Textattributebezeichner.
Anmerkung
Einige der aufgeführten Attribute werden ab Windows 8 unterstützt. Hinweise zur Versionsunterstützung finden Sie unter Textattribut-IDs.
Dieses Thema enthält die folgenden Abschnitte:
- Anmerkungsattribute
- Schriftartattribute
- Sprachattribute
- Link-Attribut
- Seitenrandattribute
- Textausrichtungsattribute
- Text decoration Attributes
- Interaktions- und Auswahlattribute
- Verwandte Themen
Anmerkungsattribute
Anmerkungsobjekte und Anmerkungstypen sind über die folgenden Attribute verfügbar.
| Attribut | Bezeichner |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Schriftartattribute
Der Name, die Größe und die Stärke einer Schriftart stehen über die folgenden Attribute zur Verfügung.
| Attribut | Bezeichner |
|---|---|
| FontName- | UIA_FontNameAttributeId |
| FontSize- | UIA_FontSizeAttributeId |
| FontWeight- | UIA_FontWeightAttributeId |
Sprachattribute
Informationen zur Sprache des Texts stehen über die folgenden Attribute zur Verfügung.
| Attribut | Bezeichner |
|---|---|
| Kultur | UIA_CultureAttributeId |
| TextFlowDirections- | UIA_TextFlowDirectionsAttributeId |
Link-Attribut
Das folgende Attribut stellt den Textbereich bereit, der das Ziel eines Links in einem Dokument ist.
| Attribut | Bezeichner |
|---|---|
| Link- | UIA_LinkAttributeId |
Seitenrandattribute
Die umgebenden Rechtecke eines Textbereichs machen die Koordinaten des Texts auf der Seite nicht verfügbar. Ein Anbieter kann die Seitenrandinformationen jedoch mithilfe der folgenden Textattribute verfügbar machen.
| Attribut | Bezeichner |
|---|---|
| MarginBottom- | UIA_MarginBottomAttributeId |
| MarginLeading- | UIA_MarginLeadingAttributeId |
| MarginTop- | UIA_MarginTopAttributeId |
| MarginTrailing- | UIA_MarginTrailingAttributeId |
Textausrichtungsattribute
Informationen zur Textausrichtung wie Einzug, Registerkarteneinstellungen und horizontale Ausrichtung sind über die folgenden Attribute verfügbar.
| Attribut | Bezeichner |
|---|---|
| HorizontalTextAlignment- | UIA_HorizontalTextAlignmentAttributeId |
| IndentationFirstLine- | UIA_IndentationFirstLineAttributeId |
| IndentationLeading | UIA_IndentationLeadingAttributeId |
| IndentationTrailing | UIA_IndentationTrailingAttributeId |
| Registerkarten | UIA_TabsAttributeId |
Textfarbattribute
Die Vordergrund- und Hintergrundtextfarben sind über die folgenden Textattribute verfügbar. Beide Farben werden als COLORREF Datentyp angegeben.
| Attribut | Bezeichner |
|---|---|
| BackgroundColor- | UIA_BackgroundColorAttributeId |
| ForegroundColor- | UIA_ForegroundColorAttributeId |
Text-Dekorationsattribute
Text-Dekorationen umfassen Bereiche wie Aufzählungszeichen, Unterstreichungen und Animationen. Wenn Text führende Aufzählungszeichen oder Zahlen enthält, sollte das für das Aufzählungszeichen oder die Nummer verwendete Text ggf. im Textstream enthalten sein.
Informationen zu Textschmuck stehen über die folgenden Attribute zur Verfügung.
| Attribut | Bezeichner |
|---|---|
| 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 |
Textformatattribute
Informationen zu Textformatvorlagen sind zwar mit den folgenden Attributen verfügbar.
| Attribut | Bezeichner |
|---|---|
| CapStyle- | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| IsItalic | UIA_IsItalicAttributeId |
| IsReadOnly- | UIA_IsReadOnlyAttributeId |
| IsSuperscript- | UIA_IsSuperscriptAttributeId |
| IsSubscript- | UIA_IsSubscriptAttributeId |
Interaktions- und Auswahlattribute
Informationen zur aktuellen Textauswahl im Bereichs- und Fokuszustand sind zwar verfügbar, aber die folgenden Attribute.
| Attribut | Bezeichner |
|---|---|
| IsActive- | UIA_IsActiveAttributeId |
| SelectionActiveEnd- | UIA_SelectionActiveEndAttributeId |
| CaretPosition- | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Verwandte Themen
-
Konzeptionelle