iTextRange::MoveEndWhile 方法 (tom.h)

将范围的末尾移动 “计数 字符”或仅超过 Cset 指定的字符集中找到的所有连续字符,以较小者为准。

语法

HRESULT MoveEndWhile(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

参数

Cset

类型: VARIANT*

在匹配中使用的字符集。 这可以是字符的显式字符串或字符集索引。 有关详细信息,请参阅 字符匹配集

Count

类型: long

要移过的最大字符数。 默认值为 tomForward,它将搜索到文章末尾。 如果 Count 大于零,则搜索将向前 (靠近故事) 末尾。 如果 Count 小于零,则搜索向后移动 (到故事) 的开头。 如果 Count 为零,则结束位置保持不变。

pDelta

类型: long*

移动末尾的实际字符数。 值可以为 Null。

返回值

类型: HRESULT

方法返回 HRESULT 值。 如果该方法成功,则返回 S_OK。 如果方法失败,它将返回以下错误代码之一。 有关 COM 错误代码的详细信息,请参阅 COM 中的错误处理

返回代码 说明
E_INVALIDARG
Cset 无效。
S_FALSE
由于其他原因而失败。

注解

如果新端位于旧开始之前,则新开始设置为等于新结束。

ITextRange::MoveEndWhile 描述的运动是合乎逻辑的,而不是几何的。 也就是说,动作是接近故事的结尾或开始。 根据语言,移动到故事末尾可能是向左移动或向右移动。

有关详细信息,请参阅 ITextRangeITextRange::Move

要求

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

请参阅

概念性

ITextRange

移动

MoveWhile

引用

文本对象模型