ITextRange::InRange 方法(tom.h)

确定此范围是位于指定区域内还是与指定区域位于同一文本中。

语法

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

参数

pRange

类型:ITextRange*

与当前范围进行比较的文本。

pValue

类型:long*

比较结果。 指针可以为 null。 仅当范围位于 pRange时,该方法才会返回 pB 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::FindTextITextRange::MoveWhileITextRange::MoveUntil 方法系列时,可以使用一个范围来指定适当的字符限制计数(例如,请参阅 ITextRange::Find中的备注)。

ITextRange::IsEqualITextRange::InRange 的特殊情况,如果 pRange 具有相同的开始和结束字符位置并且属于同一故事,则返回 pBtomTrue

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 tom.h
DLL Msftedit.dll

另请参阅

概念

FindText

ITextRange

MoveUntil

MoveWhile

参考

文本对象模型