ITextRange::InRange-Methode (tom.h)

Artikel
03/03/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 im oder mit demselben Text wie pRange befindet.

Rückgabewert

Typ: HRESULT

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

Hinweise

Damit range2 im Bereich1 enthalten ist, müssen sich beide Bereiche im selben Abschnitt befinden, und die Grenzwerte von range2 müssen einer der folgenden Anweisungen entsprechen.

Die Anfangs- und Endzeichenpositionen von range1 sind identisch mit range2. Das heißt, beide Bereiche sind degeneriert und weisen identische Einfügepunkte auf.
Range2 ist ein nichtgenerierter Bereich mit Anfangs- und Endzeichenpositionen bei oder innerhalb von bereich1.

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 Methodenfamilien ITextRange::FindText, ITextRange::MoveWhile und ITextRange::MoveUntil verwendet werden, können Sie einen Bereich zum Durchlaufen eines anderen Bereichs verwenden, indem Sie die entsprechende Grenzwertanzahl 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 Geschichte gehört.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll