ITextRange ::InRange, méthode (tom.h)

Article
07/16/2024

Détermine si cette plage se trouve dans ou au même texte qu’une plage spécifiée.

Syntaxe

HRESULT InRange(
  ITextRange *pRange,
  long       *pValue
);

Paramètres

pRange

Type : ITextRange*

Texte comparé à la plage actuelle.

pValue

Type : long*

Résultat de comparaison. Le pointeur peut être null. La méthode retourne pB est tomTrue uniquement si la plage est dans ou au même texte que pRange.

Valeur de retour

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

Pour que la plage2 soit contenue dans la plage1, les deux plages doivent se trouver dans le même article et les limites de plage2 doivent satisfaire l’une des instructions suivantes.

Les positions de caractère de début et de fin de plage1 sont identiques à la plage2. Autrement dit, les deux plages sont dégénérées et ont des points d’insertion identiques.
Range2 est une plage non générée avec des positions de caractère de début et de fin à celles de plage1.

L’exemple suivant montre comment parcourir une plage avec une autre.

    range2 = range1.Duplicate
    range2.End = range2.Start       ' Collapse range2 to its start position 
    While range2.InRange(range1)    ' Iterate so long as range2 remains within range1
         ...   ' This code would change the range2 character positions 
    Wend

Lorsque les ITextRange ::FindText, ITextRange ::MoveWhileet familles de méthodes ITextRange ::MoveUntil sont utilisées, vous pouvez utiliser une plage pour parcourir une autre en spécifiant le nombre de caractères approprié (par exemple, consultez les remarques dans ITextRange ::Find).

ITextRange ::IsEqual est un cas spécial d'ITextRange ::InRange qui retourne pBtomTrue si le pRange a les mêmes positions de caractère de début et de fin et appartient à la même histoire.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	tom.h
DLL	Msftedit.dll