ITextRangeProvider::FindText-Methode (uiautomationcore.h)

Artikel
03/03/2024

Gibt den Teil des Textbereichs zurück, der den angegebenen Text enthält.

Syntax

HRESULT FindText(
  [in]          BSTR               text,
  [in]          BOOL               backward,
  [in]          BOOL               ignoreCase,
  [out, retval] ITextRangeProvider **pRetVal
);

Parameter

[in] text

Typ: BSTR

Die zu suchende Textzeichenfolge.

[in] backward

Typ: BOOL

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

[in] ignoreCase

Typ: BOOL

TRUE , wenn die Groß-/Kleinschreibung ignoriert werden soll; andernfalls FALSE.

[out, retval] pRetVal

Typ: ITextRangeProvider**

Empfängt einen Zeiger auf den Textbereich, der dem angegebenen Text entspricht. andernfalls NULL. 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

Es gibt keine Unterscheidung zwischen ausgeblendetem und sichtbarem Text.

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 (uiAutomation.h einschließen)

Siehe auch

Konzept

ITextProvider

ITextRangeProvider

Referenz

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter

Freigeben über