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 中的错误处理。
返回代码 | 说明 |
---|---|
|
单位无效。 |
|
由于其他某种原因而失败。 |
注解
WordBasic 移动方法(如 CharRight、 CharLeft、 WordRight 和 WordLeft )是混合方法,可以执行与标准箭头键编辑行为密切相关的四项操作:
- 如果没有选择,则移动当前插入点。
- 如果存在选定内容,则移动所选内容的活动末尾。
- 将插入点转换为选定内容,反之亦然。
- 返回一个布尔值,指示是否发生了移动。
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 |
请参阅
概念性
引用