iTextRange：：Move 方法 (tom.h)

项目
03/13/2024

将插入点向前或向后移动指定数量的单位。如果范围是非退化的，则范围将折叠到任一端的插入点，具体取决于 Count，然后移动。

语法

HRESULT Move(
  long Unit,
  long Count,
  long *pDelta
);

参数

Unit

类型： long

要使用的单位。默认值为 tomCharacter。有关其他值的信息，请参阅 ITextRange 中的讨论。

Count

类型： long

要过去的单位数。默认值为 1。如果 Count 大于零，则向前移动（接近故事末尾），如果 Count 小于零，则向后移动（向开头）。如果 Count 为零，则范围保持不变。

pDelta

类型： long*

插入点经过的实际单位数。指针可以为 NULL。有关详细信息，请参见“备注”部分。

返回值

类型： HRESULT

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

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

注解

如果范围在) 插入点 (退化，此方法将尝试移动插入点计数单位。

如果范围为非生成值且 Count 大于零，此方法折叠结束字符位置处的区域，将生成的插入点向前移动到单位边界 (（如果尚未位于一个) ），然后尝试向前移动 Count - 1 Units。如果区域为非生成值且 Count 小于零，此方法折叠起始字符位置处的区域，将生成的插入点向后移动到单位边界 (（如果尚未位于一) ），然后尝试移动 |计数|- 向后 1 个单位。因此，在这两种情况下，将非退化范围折叠到插入点（无论是在折叠后移动到 Unit 的开始还是结束）都计为 Unit。

ITextRange：：Move 方法返回 pDelta = 实际移动的单位数。此方法永远不会将插入点移出此范围的故事。如果 CountUnits 会在故事开头之前移动插入点，则会将其移动到故事开头，并相应地设置 pDelta 。同样，如果 CountUnit将它移到故事末尾之外，则会移动到故事末尾。

ITextRange：：Move 方法的工作方式类似于面向 UI 的 MoveLeft 和 MoveRight 方法，只不过运动方向是逻辑的，而不是几何方向。也就是说，使用 ITextRange：：移动 方向是接近故事的末尾或开头。根据语言，向故事末尾移动可能向左或向右移动。若要了解计数，请在 Microsoft Word文档中按 Ctrl+向右键进行各种选择。在从左到右的文本中，此击键的行为与 Move(tomWord, 1)、和 MoveRight(tomWord, 1)相同。计数对应于按 Ctrl+向右键的次数。

例如，如果按 Ctrl+向右键显示以下两个图中所示的选项，则最终会在字符位置 8 处出现插入点，因为此命令将折叠其结束字符位置 (7 和 8，分别) 并移动到下一 个 tomWord 边界。

第一个选择不包括字符位置 7 处的空格，因此 Ctrl+向右键将经过空格移动到字符位置 8 处 的 tomWord 边界。第二个选定内容的结束字符位置已位于 tomWord 边界处，因此 Ctrl+向右键将折叠该边界上的选定内容。同样，对于此文本，Ctrl+向左键的作用类似于 Move(tomWord, -1)，并且 MoveLeft(tomWord, 1) 折叠字符位置 5（已在 tomWord 边界处）的第一个选定内容，因此不会再发生动作。但是 Ctrl+向左键折叠字符位置 4 处的第二个选定内容，然后移动到零，因为这是下一 个 tomWord 边界在运动方向。

返回参数 pDelta 设置为等于插入点移动的 Unit数，包括一个用于折叠非退化范围并将其移动到 Unit 边界的 Unit 。因此，如果没有发生运动和折叠，因为当范围是故事末尾的插入点时， pDelta 设置为零。此方法可用于控制处理整个故事的程序循环。

在上述两种情况下，调用 Move(tomWord, 1)pDelta 等于 1，因为范围已折叠。同样，对于这两种情况，调用 Move(tomWord, -1)pDelta 等于 -1。折叠（无论是否将单元的一部分移动到单元边界）将计为移动 的 Unit 。

运动方向是指纯文本后备存储中的逻辑字符排序。此方法可避免国际软件中的几何顺序问题，例如左与右、向上与向下。当然，编辑引擎中仍然需要这样的几何方法，因为键盘具有箭头键来调用它们。如果该范围实际上是 ITextSelection 对象，则可以使用 MoveLeft 和 MoveRight 等方法。

如果 Unit 指定 tomCharacter) (字符，则文本对象模型 (TOM) 使用 Unicode 字符集。若要在 Unicode 和多字节字符集之间转换， MultiByteToWideChar 和 WideCharToMultiByte 函数提供了在导入和导出时分别在 Unicode 和多字节字符集之间进行转换的简单方法。有关详细信息，请参阅打开。在这种情况下，使用回车/换行符 (CR/LF) 分隔段落的问题与 DBCS) (双字节字符集一样有问题。 ITextSelection UI 方法在 CR/LF 上备份，就像它是一个字符一样，但 ITextRange：：Move 方法将 CR/LFs 计数为两个字符。使用单个字符作为段落分隔符显然更好，在 TOM 中，该分隔符由字符返回表示，尽管 Unicode 段落分隔符0x2029被接受。通常，TOM 引擎应支持 CR/LF、回车 (CR) 、换行 (LF) 、垂直选项卡、表单源和0x2029。 Microsoft Rich Edit 2.0 还支持 CR/CR/LF 以实现向后兼容性。

另请参阅 ITextRange：：MoveStart 和 ITextRange：：MoveEnd 方法，它们分别移动范围 Start 或 End position CountUnits。

要求

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