IUIAutomationTextRange::GetAttributeValue-Methode (uiautomationclient.h)

Artikel
08/26/2023

Ruft den Wert des angegebenen Textattributes über den gesamten Textbereich ab.

Syntax

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

Parameter

[in] attr

Typ: TEXTATTRIBUTEID

Der Bezeichner des text-Attributs. Eine Liste der Textattribute-IDs finden Sie unter Textattributebezeichner.

[out, retval] value

Typ: VARIANT*

Empfängt den Wert des angegebenen Attributs.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Von dieser Methode abgerufene Werttyp hängt vom attr-Parameter ab. Das Aufrufen von GetAttributeValue mit dem attr-Parameter , der auf UIA_FontNameAttributeId festgelegt ist, gibt beispielsweise eine Zeichenfolge zurück, die den Schriftartnamen des Textbereichs darstellt, während das Aufrufen von GetAttributeValue mit attr auf UIA_IsItalicAttributeId einen booleschen Wert zurückgibt.

Wenn das von attr angegebene Attribut nicht unterstützt wird, empfängt der Wertparameter einen Wert, der der IUIAutomation::ReservedNotSupportedValue-Eigenschaft entspricht.

Ein Textbereich kann mehrere Werte für ein bestimmtes Attribut enthalten. Wenn ein Textbereich beispielsweise mehrere Schriftarten enthält, weist das FontName-Attribut mehrere Werte auf. Ein Attribut mit mehr als einem Wert wird als gemischtes Attribut bezeichnet. Sie können ermitteln, ob ein bestimmtes Attribut ein gemischtes Attribut ist, indem Sie den von GetAttributeValue abgerufenen Wert mit der UIAutomation::ReservedMixedAttributeValue-Eigenschaft vergleichen.

Die GetAttributeValue-Methode ruft den Attributwert ab, unabhängig davon, ob der Text ausgeblendet oder sichtbar ist. Verwenden Sie UIA_ IsHiddenAttributeId, um die Textsichtbarkeit zu überprüfen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationTextRange

Unterstützung der Benutzeroberflächenautomatisierung für Textinhalte

Share via