Méthode ITfRange::CompareEnd (msctf.h)

Article
08/24/2023

La méthode ITfRange::CompareEnd compare la position d’ancre de fin de cette plage de texte à une ancre dans une autre plage.

Syntaxe

HRESULT CompareEnd(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] LONG         *plResult
);

Paramètres

[in] ec

Modifier 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 é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	Comparez cette ancre de fin de plage à l’ancre de début de plage spécifiée.
TF_ANCHOR_END	Comparez cette ancre de fin de plage à l’ancre de fin de plage spécifiée.

[out] plResult

Pointeur vers le résultat de la comparaison entre cette ancre de fin de plage et l’ancre de la plage pWith spécifiée.

Valeur	Signification
-1	Cette ancre de fin se trouve derrière l’ancre de la plage spécifiée (position de cette position d’ancre < de fin de l’ancre de la plage spécifiée).
0	Cette ancre de fin est à la même position que l’ancre de la plage spécifiée.
+1	Cette ancre de fin est en avance sur l’ancre de la plage spécifiée (position de cette position d’ancre > de fin de l’ancre de la plage spécifiée).

Valeur retournée

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.

Notes

Cette méthode ne retourne jamais 0, sauf si les deux ancres se trouvent dans une seule région. Si l’appelant n’a besoin que d’informations sur la position des deux ancres au même emplacement, ITfRange::IsEqualEnd est plus efficace.

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

Spécifications


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	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel