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

  • Article

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

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

Voir aussi

ITextProvider2