Méthode ITextProvider2 ::GetCaretRange (uiautomationcore.h)

Fournit une plage de texte de longueur nulle à l’emplacement de l’insertion qui appartient au contrôle textuel.

Syntaxe

HRESULT GetCaretRange(
  [out]         BOOL               *isActive,
  [out, retval] ITextRangeProvider **pRetVal
);

Paramètres

[out] isActive

Type : BOOL*

TRUE si le contrôle textuel qui contient l’insertion a le focus clavier, sinon FALSE.

[out, retval] pRetVal

Type : ITextRangeProvider**

Plage de texte qui représente l’emplacement actuel de l’insertion qui appartient au contrôle textuel.

Valeur retournée

Type : HRESULT

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

Remarques

Si le paramètre isActive a la valeur FALSE, l’insertion qui appartient au contrôle textuel peut ne pas se trouver au même emplacement que l’insertion système.

Cette méthode récupère une plage de texte qu’un client peut utiliser pour rechercher le rectangle englobant de l’insertion qui appartient au contrôle textuel, ou pour trouver le texte près de l’insertion.

Configuration requise

Voir aussi

ITextProvider2