Méthode ITfFnReconversion::QueryRange (ctffunc.h)

La méthode ITfFnReconversion::QueryRange obtient la plage de texte à laquelle la conversion s’applique.

Syntaxe

HRESULT QueryRange(
  [in]  ITfRange *pRange,
        ITfRange **ppNewRange,
  [out] BOOL     *pfConvertable
);

Paramètres

[in] pRange

Pointeur vers un objet ITfRange qui couvre tout ou partie du texte à reconvertir.

ppNewRange

[in, out] Pointeur vers un pointeur ITfRange qui reçoit un objet de plage qui couvre tout le texte pouvant être reconverti. Si aucun texte couvert par pRange ne peut être reconverti, ce paramètre reçoit NULL. Dans ce cas, la méthode retourne S_OK, de sorte que l’appelant doit vérifier que ce paramètre n’est pas NULL avant d’utiliser le pointeur.

Lorsque cette méthode est implémentée par un service de texte, ce paramètre est facultatif et peut être NULL. Dans ce cas, la plage n’est pas requise.

Lorsque l’implémentation du gestionnaire TSF de cette méthode est appelée, ce paramètre n’est pas facultatif et ne peut pas avoir la valeur NULL.

[out] pfConvertable

Pointeur vers une valeur BOOL qui reçoit zéro si aucun texte couvert par pRange ne peut être reconverti ou différent de zéro dans le cas contraire.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_OUTOFMEMORY	Un échec d’allocation de mémoire s’est produit.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	ctffunc.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfFnReconversion

ITfRange