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

Article
02/29/2024

Déplace l’ancre de début de cette plage vers une ancre dans une autre plage.

Syntaxe

HRESULT ShiftStartToRange(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange,
  [in] TfAnchor     aPos
);

Paramètres

[in] ec

Contient un cookie de modification qui identifie le contexte de modification obtenu à partir de ITfDocumentMgr ::CreateContext ou ITfEditSession ::D oEditSession.

[in] pRange

Pointeur vers une interface ITfRange qui contient l’ancre vers laquelle l’ancre de début est déplacée.

[in] aPos

Contient l’une des valeurs TfAnchor qui spécifie l’ancre de pRange vers laquelle l’ancre de début est déplacé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_INVALIDARG	pRange n’est pas valide.
E_FAIL	Une erreur non spécifiée s'est produite.
TF_E_NOLOCK	Le contexte de modification identifié par ec n’a pas de verrou en lecture seule.

Remarques

Les positions de début et de fin d’une plage sont appelées ancres.

Si l’opération de décalage entraîne le déplacement de l’ancre de début de plage au-delà de l’ancre de fin, l’ancre de fin est déplacée au même emplacement que l’ancre de début.

Cette méthode est plus efficace que ITfRange ::ShiftStart et doit être utilisée dans la mesure du possible.

Configuration requise

Condition requise	Valeur
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