ITextRange：：InRange 方法 （tom.h）

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

語法

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。

要求

另請參閱

概念

FindText

ITextRange

MoveUntil

MoveWhile

參考

文字物件模型