ITextRange::MoveStartUntil 方法 (tom.h)

移动该区域的起始位置,移动 Cset 指定的字符集中找到的第一个字符的位置,前提是该字符位于起始位置的 Count 字符内。

语法

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

参数

Cset

类型: VARIANT*

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

Count

类型: long

要过去的最大字符数。 默认值为 tomForward,它搜索到文章末尾。 如果 Count 大于零,则搜索是向前搜索(靠近文章末尾),如果 Count 小于零,则搜索是向后搜索-向开头。 如果 Count 为零,则起始位置保持不变。

pDelta

类型: long*

移动范围开头的实际字符数,如果 Count 大于零,则为匹配项加 1;如果 Count 小于零,则为匹配项加 1。 值可以为 Null。

返回值

类型: HRESULT

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

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

注解

如果在开始位置的计数位置中找不到 Cset 中的字符,则区域保持不变。

如果新开始位于旧端之后,则新起点设置为等于新开始。

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

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

要求

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

请参阅

概念性

ITextRange

移动

MoveUntil

引用

文本对象模型