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

Article
08/24/2023

Déplace l’ancre de début dans une région adjacente.

Syntaxe

HRESULT ShiftStartRegion(
  [in]  TfEditCookie ec,
  [in]  TfShiftDir   dir,
  [out] BOOL         *pfNoRegion
);

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] dir

Contient l’une des valeurs TfShiftDir qui spécifie la région adjacente vers laquelle l’ancre de début est déplacée.

[out] pfNoRegion

Pointeur vers un boOL qui reçoit un indicateur qui indique si l’ancre est positionnée à côté d’une autre région. Reçoit une valeur différente de zéro si l’ancre n’est pas adjacente à une autre région ou à zéro dans le cas contraire.

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	pfNoRegion n’est pas valide.
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.

L’ancre doit être positionnée à côté de la région souhaitée avant d’appeler cette méthode. Si ce n’est pas le cas, pfNoRegion reçoit une valeur différente de zéro et l’ancre n’est pas déplacée. Si l’ancre est adjacente à la région souhaitée, pfNoRegion reçoit zéro et l’ancre est déplacée vers la région.

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