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

Article
03/03/2024

Déplace les extrémités de cette plage à la fin de la dernière unité qui se chevauche dans la plage.

Syntaxe

HRESULT EndOf(
  long Unit,
  long Extend,
  long *pDelta
);

Paramètres

Unit

Type : long

Unité à utiliser. Valeur par défaut : tomWord. Pour obtenir la liste des autres valeurs Unit , consultez la discussion sous ITextRange.

Extend

Type : long

Indicateur de la façon dont le décalage de la plage se termine doit se poursuivre. Il peut s’agir de l’un des éléments suivants.

0 ou tomMove	Réduit une plage non dégénérée à la fin de la plage d’origine en déplaçant le point d’insertion. Il s’agit de la valeur par défaut.
1 (ou tomExtend)	Déplace End à la fin de l’unité qui se chevauche. Ne déplace pas l’option Démarrer.

pDelta

Type : long*

Nombre de caractères que La fin est passée. La valeur du pointeur peut être null. Lors du retour, la valeur de pDelta est le nombre de caractères que le point d’insertion ou End est déplacé plus 1 si une réduction se produit vers l’entrée End. Si la plage inclut le CR final (retour chariot) (à la fin de l’histoire) et Extend = tomMove, pDelta est défini sur -1, pour indiquer que la réduction s’est produite avant la fin de la plage (car un point d’insertion ne peut pas exister au-delà du CR final).

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

À des fins de comparaison, la méthode ITextRange ::StartOf déplace la plage jusqu’au début de la première unité qui se chevauche dans la plage. Notez que les méthodes ITextRange ::StartOf et ITextRange ::EndOf diffèrent des méthodes HomeKey et EndKey en ce que ces dernières s’étendent à partir de la fin active, tandis que ITextRange ::StartOf s’étend de Start et ITextRange ::EndOf s’étend de End. Si la plage est un point d’insertion sur une limite entre unités, ITextRange ::EndOf ne change pas End. En particulier, l’appel de ITextRange ::EndOf (tomCharacter, *, *) ne change pas End, sauf pour un point d’insertion au début d’un article.

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