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

Article
03/06/2024

Définit la position de fin de la plage.

Syntaxe

HRESULT SetEnd(
  long cpLim
);

Paramètres

cpLim

Type : long

Nouvelle position de fin.

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

Si la nouvelle position de fin est inférieure à la position de début, cette méthode définit également la position de début sur cp ; autrement dit, la plage devient un point d’insertion.

Si cette plage est en fait la sélection, la position de fin devient la fin active et, si l’affichage n’est pas figé, il est fait défiler vers l’affichage.

ITextRange ::SetStart définit la position de début de la plage et ITextRange ::SetRange définit les deux extrémités de plage simultanément. Pour convertir une plage non dégénérée, r, en un dégénéré (point d’insertion) à la position de début, utilisez

r.End = r.Start

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

Pour ajouter 1 à la position de fin, à moins qu’il ne se trouve à la fin de l’article, utilisez :

r.End = r.End + 1

Cela fait également de la position de fin l’extrémité 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