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

Article
03/06/2024

Déplace la fin de la plage vers la position du caractère du premier caractère trouvé qui se trouve dans l’ensemble de caractères spécifié par Cset, à condition que le caractère se trouve dans Nombre de caractères de la fin de la plage.

Syntaxe

HRESULT MoveEndUntil(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

Paramètres

Cset

Type : VARIANT*

Jeu de caractères à utiliser dans la correspondance. Il peut s’agir d’une chaîne explicite de caractères ou d’un index de jeu de caractères. Pour plus d’informations, consultez Jeux de correspondances de caractères.

Count

Type : long

Nombre maximal de caractères à dépasser. La valeur par défaut est tomForward, qui recherche jusqu’à la fin de l’article. Si Count est supérieur à zéro, la recherche avance (vers la fin de l’article). Si Count est inférieur à zéro, la recherche se déplace vers l’arrière (vers le début de l’histoire). Si Count est égal à zéro, la position de fin est inchangée.

pDelta

Type : long*

Nombre réel de caractères dont la fin de plage est déplacée, plus 1 pour une correspondance si Count est supérieur à zéro, et –1 pour une correspondance si Count est inférieur à zéro. 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
Valeur	Signification
E_INVALIDARG	Cset n’est pas valide.
S_FALSE	Échec pour une autre raison.

Remarques

Si aucun caractère du jeu spécifié par Cset n’est trouvé dans les positions de nombre de la fin de la plage, la plage reste inchangée. Si la nouvelle fin précède l’ancien début, le nouveau début est défini sur la nouvelle fin.

Le mouvement décrit par ITextRange ::MoveEndUntil 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