Partager via


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

Déplace l’ancre de début d’une composition.

Syntaxe

HRESULT ShiftStart(
  [in] TfEditCookie ecWrite,
  [in] ITfRange     *pNewStart
);

Paramètres

[in] ecWrite

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

[in] pNewStart

Pointeur vers un objet ITfRange qui contient la nouvelle position d’ancre de départ. L’ancre de début du contexte est déplacée vers l’ancre de début de cette plage. Cette méthode échoue si l’ancre de début de cette plage est positionnée au-delà de l’ancre de fin de la composition.

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
L’ancre de début de pNewStart est positionnée au-delà de l’ancre de fin de la composition ou pNewStart n’est pas valide.
E_UNEXPECTED
La composition est déjà terminée.
TF_E_NOLOCK
Le contexte de modification identifié par ecWrite n’a pas de verrou en lecture/écriture.

Remarques

Cette méthode entraîne la suppression de la propriété GUID_PROP_COMPOSING de tout texte supprimé de la composition. De même, la propriété GUID_PROP_COMPOSING est également ajoutée à tout texte ajouté à la composition.

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

Voir aussi

Interface ITfComposition, ITfEditSession ::D oEditSession, interface ITfRange, ITfComposition ::ShiftEnd