Freigeben über

Benutzeroberflächenautomatisierung Textattribute

  • Artikel

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

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

 

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

 

Konzept

Informationen zu den Benutzeroberflächenautomatisierung Text- und TextRange-Steuerelementmustern

Text- und TextRange-Steuerelementmuster

Arbeiten mit textbasierten Steuerelementen