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 移动方法(如 CharRightCharLeftWordRightWordLeft )是混合方法,可以执行与标准箭头键编辑行为密切相关的四项操作:

  • 如果没有选择,则移动当前插入点。
  • 如果存在选定内容,则移动所选内容的活动末尾。
  • 将插入点转换为选定内容,反之亦然。
  • 返回一个布尔值,指示是否发生了移动。
MoveLeftMoveRightExtend 参数使你能够与上述前三项保持一致,而 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 会导致范围变得非退化,左端为活动端。

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

要求

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

请参阅

概念性

ITextRange

ITextSelection

MoveRight

引用

文本对象模型