ITextRangeProvider::GetAttributeValue-Methode (uiautomationcore.h)

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

Syntax

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

[in] attributeId

Typ: TEXTATTRIBUTEID

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

[out, retval] pRetVal

Empfängt eine der folgenden Optionen.

Die Adresse eines Objekts, das den Wert des angegebenen Attributs darstellt. Der Datentyp des Werts variiert abhängig vom angegebenen Attribut. Wenn beispielsweise attributeIdUIA_FontNameAttributeId ist, gibt GetAttributeValue eine Zeichenfolge zurück, die den Schriftartnamen des Textbereichs darstellt. Wenn attributeId jedoch UIA_IsItalicAttributeId ist, gibt GetAttributeValue einen booleschen Wert zurück.
Die Adresse des Werts, der von der UiaGetReservedMixedAttributeValue-Funktion abgerufen wird, wenn der Wert des angegebenen Attributs im Textbereich variiert.
Die Adresse des von der UiaGetReservedNotSupportedValue-Funktion abgerufenen Werts, wenn das angegebene Attribut vom Anbieter oder vom Steuerelement nicht unterstützt wird.

Dieser Parameter wird nicht initialisiert übergeben.

Typ: HRESULT

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

Die GetAttributeValue-Methode sollte den Attributwert unabhängig davon abrufen, ob der Text ausgeblendet oder sichtbar ist.


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (uiAutomation.h einschließen)

Konzept

ITextProvider

Referenz