ITextRange::MoveEndUntil 方法 (tom.h)

将范围的末尾移动到 Cset 指定的字符集中找到的第一个字符的字符位置,前提是该字符位于范围末尾的 Count 字符内。

语法

HRESULT MoveEndUntil(
  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
由于其他某种原因而失败。

注解

如果在范围末尾的 Count 位置内找不到 Cset 指定的集中的字符,则区域保持不变。 如果新末尾位于旧开始之前,则新开始设置为等于新结束。

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

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

要求

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

请参阅

概念性

ITextRange

移动

MoveUntil

引用

文本对象模型