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

Article
08/24/2023

Déplace l’ancre de début de la plage.

Syntaxe

HRESULT ShiftStart(
  [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. Elle est obtenue à partir de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] cchReq

Contient le nombre de caractères que l’ancre de début est décalée. Une valeur négative fait reculer l’ancre 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 été décalée.

[in] pHalt

Pointeur vers une structure TF_HALTCOND qui contient des conditions relatives au 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_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
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.

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::ShiftStartRegion 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 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.

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

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