ITextRange：：InRange 方法 (tom.h)

發行項
03/03/2024

判斷此範圍是否位於或與指定範圍相同的文字中。

語法

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

參數

pRange

類型： ITextRange*

與目前範圍比較的文字。

pValue

類型： long*

比較結果。指標可以是 Null。只有在範圍位於或與 pRange 相同的文字時，方法才會傳回 pB 為 tomTrue。

傳回值

類型： HRESULT

方法會傳回 HRESULT 值。如果方法成功，則會傳回 S_OK。如果方法失敗，則會傳回S_FALSE。

備註

若要讓 range2 包含在 range1 中，這兩個範圍都必須位於相同的本文中，而 range2 的限制必須滿足下列其中一個語句。

range1 的開始和結束字元位置與 range2 相同。也就是說，這兩個範圍都是變質的，而且具有相同的插入點。
Range2 是一個非產生範圍，其開頭和結尾字元位置位於或 range1 的範圍內。

下列範例示範如何使用另一個範圍來逐步執行。

    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

使用 ITextRange：：FindText、 ITextRange：：MoveWhile 和 ITextRange：：MoveUntil 方法系列時，您可以使用一個範圍來逐步解說另一個範圍，方法是指定 (的適當字元數，以取得範例，請參閱 ITextRange：：Find) 中的。

ITextRange：：IsEqual 是 ITextRange：：InRange 的特殊案例，如果 pRange 具有相同的開始和結束字元位置，且屬於相同的本文，則會傳回 pBtomTrue。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	tom.h
Dll	Msftedit.dll