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 中的错误处理。
返回代码 | 说明 |
---|---|
|
含义 |
|
Cset 无效。 |
|
由于其他某种原因而失败。 |
注解
如果在范围末尾的 Count 位置内找不到 Cset 指定的集中的字符,则区域保持不变。 如果新末尾位于旧开始之前,则新开始设置为等于新结束。
ITextRange::MoveEndUntil 描述的运动是逻辑的,而不是几何的。 也就是说,动作是接近故事的结尾或开始。 根据语言,移动到故事末尾可能是向左移动或向右移动。
有关详细信息,请参阅 ITextRange 和 ITextRange::Move。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | tom.h |
DLL | Msftedit.dll |
请参阅
概念性
引用