ITextRangeProvider::GetAttributeValue-Methode (uiautomationcore.h)

  • Artikel

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

Syntax

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

Parameter

[in] attributeId

Typ: TEXTATTRIBUTEID

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

[out, retval] pRetVal

Typ: VARIANT*

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.

Rückgabewert

Typ: HRESULT

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

Hinweise

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

Anforderungen

   
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)

Siehe auch

Konzept

ITextProvider

ITextRangeProvider

Referenz

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter