IUIAutomationTextRange::FindAttribute-Methode (uiautomationclient.h)

Ruft eine Textbereichsteilmenge ab, die über den angegebenen Text-Attributwert verfügt.

Syntax

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID        attr,
  [in]          VARIANT                val,
  [in]          BOOL                   backward,
  [out, retval] IUIAutomationTextRange **found
);

Parameter

[in] attr

Typ: TEXTATTRIBUTEID

Der Bezeichner des text-Attributs für die abzurufende Textbereichsteilmenge. Eine Liste der Textattribute-IDs finden Sie unter Textattribute-IDs.

[in] val

Typ: VARIANT

Der Wert des Attributs. Dieser Wert mit dem für das Attribut angegebenen Typ übereinstimmen.

[in] backward

Typ: BOOL

TRUE , wenn der zuletzt auftretende Textbereich anstelle des ersten zurückgegeben werden soll; andernfalls FALSE.

[out, retval] found

Typ: IUIAutomationTextRange**

Empfängt einen Zeiger auf den Textbereich mit einem übereinstimmenden Attribut- und Attributwert. andernfalls NULL.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die FindAttribute-Methode ruft übereinstimmenden Text ab, unabhängig davon, ob der Text ausgeblendet oder sichtbar ist. Verwenden Sie UIA_IsHiddenAttributeId , um die Textsichtbarkeit zu überprüfen.

Anforderungen

Anforderung	Wert
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

Benutzeroberflächenautomatisierung Unterstützung für Textinhalte