ITextRangeProvider::FindAttribute-Methode (uiautomationcore.h)

Artikel
03/06/2024

Gibt eine Textbereichsteilmenge zurück, die über den angegebenen Textattributewert verfügt.

Syntax

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

Parameter

[in] attributeId

Typ: TEXTATTRIBUTEID

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

[in] val

Typ: VARIANT

Der zu suchende Attributwert. Dieser Wert mit dem für das Attribut angegebenen Typ übereinstimmen.

[in] backward

Typ: BOOL

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

[out, retval] pRetVal

Typ: ITextRangeProvider**

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. Clients können UIA_IsHiddenAttributeId verwenden, um die Textsichtbarkeit zu überprüfen.

Anforderungen

Anforderung	Wert
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 (include UIAutomation.h)

Siehe auch

Konzept

ITextProvider

ITextRangeProvider

Referenz

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter

Freigeben über