通过

ITextSelection：：MoveLeft 方法 (tom.h)

  • 项目

通用化向左键的功能。

语法

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

注解

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

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

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

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

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

要求

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

请参阅

概念性

ITextRange

ITextSelection

MoveRight

引用

文本对象模型