ITfRange ::IsEqualEnd, méthode (msctf.h)

Article
03/05/2025

La méthode ITfRange ::IsEqualStart vérifie que l’ancre de fin de cette plage de texte correspond à une ancre d’une autre plage spécifiée.

Syntaxe

HRESULT IsEqualEnd(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] BOOL         *pfEqual
);

Paramètres

[in] ec

Modifiez le cookie obtenu à partir de ITfDocumentMgr ::CreateContext ou ITfEditSession ::D oEditSession.

[in] pWith

Pointeur vers une plage spécifiée dans laquelle une ancre doit être comparée à cette ancre de fin de plage.

[in] aPos

Élément d’énumération qui indique l’ancre de la plage pWith spécifiée à comparer avec cette ancre de fin de plage.

Valeur	Signification
TF_ANCHOR_START	Compare cette ancre de fin de plage à l’ancre de début de plage spécifiée.
TF_ANCHOR_END	Compare cette ancre de fin de plage à l’ancre de fin de plage spécifiée.

[out] pfEqual

Pointeur vers une valeur booléenne. Lors du retour, TRUE indique que l’ancre de plage pWith spécifiée correspond à cette ancre de fin de plage. FALSE indique sinon.

Valeur de retour

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

Valeur	Description
S_OK	La méthode a réussi.
E_FAIL	Une erreur non spécifiée s’est produite.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
TF_E_NOLOCK	La valeur du paramètre ec est un cookie non valide, ou l’appelant n’a pas de verrou en lecture seule.

Remarques

Cette méthode est identique à ITfRange ::IsEqualStart, sauf que l’ancre de fin de cette plage est comparée à une ancre d’une autre plage spécifiée.

Cette méthode est fonctionnellement équivalente, mais plus efficace qu'ITfRange ::CompareEnd.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	msctf.h
DLL	Msctf.dll
redistribuable	TSF 1.0 sur Windows 2000 Professionnel