Benutzeroberflächenautomatisierung Textattribute
In diesem Thema wird beschrieben, wie Microsoft Benutzeroberflächenautomatisierung die Format- und Formateigenschaften (Textattribute) von Textinhalten verfügbar macht, und stellt eine Liste der unterstützten Textattribute bereit.
Benutzeroberflächenautomatisierung 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 über ein bestimmtes Attribut verfügt. 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-Steuerelementmuster unterstützt. Die Attributnamen werden von den Benutzeroberflächenautomatisierung Textattributebezeichnern 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.
Hinweis
Einige der aufgeführten Attribute werden ab Windows 8 unterstützt. Hinweise zur Versionsunterstützung finden Sie unter Textattributebezeichner .
Dieses Thema enthält folgende Abschnitte:
- Anmerkungsattribute
- Schriftartattribute
- Sprachattribute
- Link-Attribut
- Seitenrandattribute
- Textausrichtungsattribute
- Textfarbattribute
- Textdekorationsattribute
- Textformatattribute
- Interaktions- und Auswahlattribute
- Zugehörige Themen
Anmerkungsattribute
Anmerkungsobjekte und Anmerkungstypen sind über die folgenden Attribute verfügbar.
| attribute | Bezeichner |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Schriftartattribute
Name, Größe und Gewichtung einer Schriftart sind über die folgenden Attribute verfügbar.
| attribute | Bezeichner |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| Schriftbreite | UIA_FontWeightAttributeId |
Sprachattribute
Informationen zur Sprache des Texts sind über die folgenden Attribute verfügbar.
| attribute | 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.
| attribute | Bezeichner |
|---|---|
| Link | UIA_LinkAttributeId |
Seitenrandattribute
Die umgebenden Rechtecke eines Textbereichs machen die Koordinaten des Texts auf der Seite nicht verfügbar. Ein Anbieter kann jedoch die Seitenrandinformationen mit den folgenden Textattributen verfügbar machen.
| attribute | 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.
| attribute | 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.
| attribute | Bezeichner |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Textdekorationsattribute
Textdekorationen umfassen Bereiche wie Aufzählungszeichen, Unterstreichungen und Animationen. Wenn Text führende Aufzählungszeichen oder Zahlen enthält, sollte das Symbol oder der Text, der für das Aufzählungszeichen oder die Zahl verwendet wird, ggf. in den Textstream aufgenommen werden.
Informationen zu Textdekorationen sind über die folgenden Attribute verfügbar.
| attribute | 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 über die folgenden Attribute verfügbar.
| attribute | 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 über die folgenden Attribute verfügbar.
| attribute | Bezeichner |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| CaretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Zugehörige Themen
-
Konzept
-
Informationen zu den Benutzeroberflächenautomatisierung Text- und TextRange-Steuerelementmustern