通过

ITextSelection：：MoveRight 方法 (tom.h)

  • 项目

通用化向右键的功能。

语法

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

参数

Unit

类型： long

要使用的单位。 可以是以下任一项。

值 相应的组合键 含义
tomCharacter 向右键 向右移动一个字符位置。 这是默认值。
tomWord Ctrl+向右键 向右移动一个单词。
 

请注意，如果 Count 小于零，则向左移动。

Count

类型： long

要过去的单位数。 默认值为 1。 如果 Count 小于零，则向左移动。

Extend

类型： long

指示如何更改所选内容的标志。 如果 Extend 为零 (或 tomMove) ，该方法会将所选内容折叠到活动末尾的插入点，然后将其移动。 如果 Extend 为 1 (或 tomExtend) ，则 方法将移动活动端并单独保留另一端。 默认值为零。 非零 扩展 值对应于除 单元中所述的组合键外，还对应于按下的 Shift 键。

pDelta

类型： long*

插入点或活动端向左移动的实际单位计数。 此参数可以为 null。 当 Extend 为 0 时，折叠所选内容将计为一个单位。

返回值

类型： HRESULT

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

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

注解

Microsoft WordBasic 移动方法（如 CharRight、 CharLeft、 WordRight 和 WordLeft ）是混合方法，可以执行与标准箭头键编辑行为密切相关的四项操作：

  • 如果没有选择，则移动当前插入点。
  • 如果存在选定内容，则移动所选内容的活动末尾。
  • 将插入点转换为选定内容，反之亦然。
  • 返回一个布尔值，指示是否发生了移动。
MoveLeft 和 MoveRight 的 Extend 参数使你能够与上述前三项保持一致，而 pDelta 是第四个项的通用化。 例如，给定由单个区域组成的选定区域， (从左到右字符) 。
ITextSelection WordBasic 函数
s.MoveRight tomWord， 1， 1 WordRight 1,1 将活动末尾向右移动一个单词。
s.MoveLeft tomCharacter， 1， 1 CharLeft 1,1 将活动末尾向左移动一个字符。
 

与 WordBasic 中一样，如果 Count 小于零，则交换左和右的含义，这 MoveLeft (Unit, Count, Extend) 等效于 MoveRight(Unit, -Count, Extend)。

类似于 WordBasic 和向右键 UI 行为，对 MoveRight(Unit, Count) 退化的选择调用会移动插入点指定的单位数。 在退化范围中，调用 MoveRight(Unit, Count, 1)Count where 大于零会导致范围变得非退化，右端为活动端。

当 Extend 为 tomExtend (或非零) 时， MoveRight 仅移动所选内容的活动端，将另一端保留到它所在的位置。 但是，如果 Extend 等于零，并且选择从非生成范围开始， MoveRight(Unit, Count) 其中 Count 大于零将活动端 Count 向右移动 1 个单位，然后将另一端移动到活动端。 换句话说，它在活动端生成插入点。 折叠范围计为一个单位。 因此， MoveRight(tomCharacter) 在选择的右端将非退化选择转换为退化的选择。 此处， Count 的默认值为 1，Extend 的默认值为零。 此示例对应于按向右键。 MoveLeft 和 MoveRight 与 ITextRange 移动方法相关，但不同之处在于它们显式使用活动端 (通过按 Shift 键) 移动的末尾。

要求

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

请参阅

概念性

ITextRange

ITextSelection

MoveLeft

引用

文本对象模型