TextRange_FindText-Funktion (uiautomationcoreapi.h)

Artikel
03/03/2024

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen (Component Object Model) von Microsoft Benutzeroberflächenautomatisierung verwenden.

Gibt den ersten Textbereich in der angegebenen Richtung zurück, der den vom Client gesuchten Text enthält.

Syntax

HRESULT TextRange_FindText(
  [in]  HUIATEXTRANGE hobj,
  [in]  BSTR          text,
  [in]  BOOL          backward,
  [in]  BOOL          ignoreCase,
  [out] HUIATEXTRANGE *pRetVal
);

Parameter

[in] hobj

Typ: HUIATEXTRANGE

Der zu durchsuchende Textbereich.

[in] text

Typ: BSTR

Die zu suchende Zeichenfolge.

[in] backward

Typ: BOOL

TRUE , um rückwärts zu suchen; andernfalls FALSE.

[in] ignoreCase

Typ: BOOL

TRUE , um eine Suche ohne Beachtung der Groß-/Kleinschreibung anzugeben; andernfalls FALSE.

[out] pRetVal

Typ: HUITEXTRANGE*

Wenn diese Funktion zurückgibt, enthält den Textbereich für die erste Textspanne, die der vom Client gesuchten Zeichenfolge entspricht. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert vorhanden ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Share via