ITextRange::InRange-Methode (tom.h)

Artikel
07/16/2024

Bestimmt, ob sich dieser Bereich innerhalb oder im selben Text wie ein angegebener Bereich befindet.

Syntax

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

Parameter

pRange

Typ: ITextRange-*

Text, der mit dem aktuellen Bereich verglichen wird.

pValue

Typ: long*

Das Vergleichsergebnis. Der Zeiger kann null sein. Die Methode gibt pB- nur dann tomTrue zurück, wenn sich der Bereich in oder im selben Text wie pRangebefindet.

Rückgabewert

Typ: HRESULT-

Die Methode gibt einen HRESULT- Wert zurück. Wenn die Methode erfolgreich ist, wird S_OKzurückgegeben. Wenn die Methode fehlschlägt, wird S_FALSE zurückgegeben.

Bemerkungen

Damit Bereich2 in Bereich1 enthalten ist, müssen sich beide Bereiche im gleichen Textabschnitt befinden, und die Grenzwerte von Bereich2 müssen eine der folgenden Anweisungen erfüllen.

Die Anfangs- und Endzeichenpositionen von Bereich1 entsprechen dem Bereich2. Das heißt, beide Bereiche werden degeneriert und weisen identische Einfügepunkte auf.
Range2 ist ein nicht generierter Bereich mit Anfangs- und Endzeichenpositionen an oder innerhalb des Bereichs1.

Das folgende Beispiel zeigt, wie Sie einen Bereich mit einem anderen durchlaufen.

    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

Wenn die ITextRange::FindText, ITextRange::MoveWhileund ITextRange::MoveUntil Methodenfamilien verwendet werden, können Sie einen Bereich verwenden, um einen anderen zu durchlaufen, indem Sie die entsprechende Anzahl von Zeichen angeben (ein Beispiel finden Sie in den Anmerkungen in ITextRange::Find).

ITextRange::IsEqual ist ein Sonderfall von ITextRange::InRange, der pBtomTrue- zurückgibt, wenn die pRange die gleichen Anfangs- und Endzeichenpositionen aufweist und zur gleichen Story gehört.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	tom.h
DLL-	Msftedit.dll