Méthode ITextRangeProvider ::FindText (uiautomationcore.h)

Article
03/13/2024

Retourne un sous-ensemble de la plage de texte qui contient le texte spécifié.

Syntaxe

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

Paramètres

[in] text

Type : BSTR

Chaîne de texte à rechercher.

[in] backward

Type : BOOL

TRUE si la dernière plage de texte doit être retournée au lieu de la première ; sinon , FALSE.

[in] ignoreCase

Type : BOOL

TRUE si la casse doit être ignorée ; sinon , FALSE.

[out, retval] pRetVal

Type : ITextRangeProvider**

Reçoit un pointeur vers la plage de texte correspondant au texte spécifié ; sinon , NULL. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Il n’existe aucune distinction entre le texte masqué et le texte visible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcore.h (incluez UIAutomation.h)