iTextRange::EndOf 方法 (tom.h)

将此范围的终点移动到范围中最后一个重叠 单位 的末尾。

语法

HRESULT EndOf(
  long Unit,
  long Extend,
  long *pDelta
);

参数

Unit

类型: long

要使用的单位。 默认值: tomWord。 有关其他 Unit 值的列表,请参阅 ITextRange 下的讨论。

Extend

类型: long

指示范围结束的移动方式为继续。 可以是以下项之一。

0 或 tomMove 通过移动插入点,将非退化区域折叠到原始范围的末尾。 这是默认值。
1 个 (或 tomExtend) 将 End 移动到重叠 单位的末尾。 不移动“开始”菜单。

pDelta

类型: long*

End 经过的字符计数。 指针的值可以为 null。 返回时, pDelta 的值是插入点或 End 移动的字符数 加上 1(如果条目 End 发生折叠)。 如果范围包括故事) 末尾的最终 CR (回车) (,并且 Extend = tomMove,则 pDelta 设置为 –1,以指示折叠发生在范围结束 (之前 ,因为插入点不能存在于最终 CR) 之外。

返回值

类型: HRESULT

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

返回代码 说明
E_NOTIMPL
不支持单位。
S_FALSE
由于其他原因而失败。

注解

为了进行比较, ITextRange::StartOf 方法将范围结束移动到范围中第一个重叠 单位 的开头。 请注意, ITextRange::StartOfITextRange::EndOf 方法不同于 HomeKeyEndKey 方法,后者从活动端扩展,而 ITextRange::StartOf 从 Start 扩展, ITextRange::EndOf 从 End 扩展。 如果范围是 单位s 之间的边界上的插入点, 则 ITextRange::EndOf 不会更改 End。 具体而言,调用 ITextRange::EndOf (tomCharacter、*、*) 不会更改 End,除非故事开头的插入点。

要求

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

请参阅

概念性

EndKey

HomeKey

ITextRange

引用

StartOf

文本对象模型