iTextRange::MoveStartWhile 方法 (tom.h)

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

语法

HRESULT MoveStartWhile(
  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::MoveStartWhile 描述的运动是合乎逻辑的,而不是几何的。 也就是说,动作是接近故事的结尾或开始。 根据语言,移动到故事末尾可能是向左移动或向右移动。

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

要求

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

请参阅

概念性

ITextRange

移动

MoveWhile

引用

文本对象模型