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

Article
08/24/2023

Déplace l’ancre de fin de la plage.

Syntaxe

HRESULT ShiftEnd(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

Paramètres

[in] ec

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

[in] cchReq

Contient le nombre de caractères que l’ancre de fin est décalée. Une valeur négative entraîne le déplacement de l’ancre vers l’arrière et une valeur positive fait avancer l’ancre.

[out] pcch

Pointeur vers une valeur LONG qui reçoit le nombre de caractères que l’ancre a décalé.

[in] pHalt

Pointeur vers une structure TF_HALTCOND qui contient des conditions sur le décalage. Ce paramètre est facultatif et peut être NULL.

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	Le contexte de modification identifié par ec n’a pas de verrou en lecture seule.

Notes

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

Cette méthode ne peut pas déplacer une ancre au-delà d’une limite de région. Si le décalage atteint une limite de région, le nombre de caractères réellement déplacés est inférieur à celui demandé. ITfRange::ShiftEndRegion est utilisé pour déplacer l’ancre vers une région adjacente.

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

ITfRange::ShiftEnd peut être une opération longue. Pour de meilleures performances, utilisez ITfRange::ShiftEndToRange lorsque cela est possible.

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