Méthode ITextRange ::SetStart (tom.h)

Article
03/03/2024

Définit la position du caractère pour le début de cette plage.

Syntaxe

HRESULT SetStart(
  [in] long cpFirst
);

Paramètres

[in] cpFirst

Type : long

Nouvelle position de caractère pour le début de la plage.

Valeur retournée

Type : HRESULT

La méthode retourne une valeur HRESULT . Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne S_FALSE.

Remarques

Notez que si cpFirst est supérieur à la position de fin de la plage, cette méthode définit la position de fin égale à cpFirst, ce qui fait de la plage un point d’insertion. Si cette plage est la sélection, la position de début devient la fin active et fait défiler l’affichage si l’affichage n’est pas figé.

ITextRange ::SetEnd définit la position de fin de la plage, et ITextRange ::SetRange définit les deux extrémités de plage simultanément. L’exemple suivant montre comment convertir une plage non dégénérée en une plage dégénérée (point d’insertion).

range.End = range.Start

De même, range.Start = range.End convertit la plage en point d’insertion à la position de fin.

L’exemple suivant ajoute 1 à la position de fin, si elle n’est pas à la fin de l’article.

range.End = range.End + 1

Cela fait également de la position de fin la fin de la plage active, et elle peut transformer une plage dégénérée en une plage non dégénérée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h
DLL	Msftedit.dll