ITextRange：：InRange 方法（tom.h）

發行項
07/16/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 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	tom.h
DLL	Msftedit.dll