Partager via


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

Déplace la position de fin de la plage.

Syntaxe

HRESULT MoveEnd(
  long Unit,
  long Count,
  long *pDelta
);

Paramètres

Unit

Type : long

Unités par lesquelles déplacer la fin de la plage. La valeur par défaut est tomCharacter. Pour obtenir la liste des autres valeurs d’unité, consultez ITextRange.

Count

Type : long

Nombre d’unités à dépasser. La valeur par défaut est 1. Si Nombre est supérieur à zéro, le mouvement est vers l’avant( vers la fin de l’histoire) et si Le nombre est inférieur à zéro, le mouvement est vers l’arrière vers le début. Si Count est égal à zéro, la position de fin est inchangée.

pDelta

Type : long*

Nombre réel d’unités au-delà de laquelle la position de fin de la plage est déplacée. La valeur peut être Null.

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 l’un des codes d’erreur suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour Description
E_NOTIMPL
L’unité n’est pas prise en charge.
S_FALSE
Échec pour une autre raison.

Remarques

Si la nouvelle position de fin précède l’ancienne position de début, la nouvelle position de début est définie sur la nouvelle position de fin ; autrement dit, elle devient une plage dégénérée ou un point d’insertion.

Le mouvement décrit par ITextRange ::MoveEnd est logique plutôt que géométrique. Autrement dit, le mouvement est vers la fin ou vers le début d’une histoire. Selon la langue, le déplacement vers la fin de l’histoire peut être un déplacement vers la gauche ou vers la droite.

Pour plus d’informations, consultez ITextRange et ITextRange ::Move.

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

Voir aussi

Conceptuel

ITextRange

Déplacer

Référence

Modèle objet texte