IMTextCursor 回调子例程

在线编辑

用途

要求应用程序移动文本光标。

语法

int IMTextCursor(IM, Direction, Cursor, UData)
IMObject  IM;
uint  Direction;
int * Cursor;
caddr_t  UData;

描述

当将 "光标上移" 或 "光标下移" 键输入到 IMFilter 和 IMLookupString 子例程时， "输入方法" 将调用 IMTextCursor 子例程。

此子例程将文本区域中新的显示光标位置设置为 Cursor 参数所指向的整数。 光标位置相对于文本区域的顶部。 如果值为-1，则表示不应移动光标。

由于输入方法不知道屏幕的实际长度，因此它始终将文本字符串视为一维 (单行)。 但是，在终端仿真器中，文本字符串有时会回绕到下一行。 IMTextCursor 子例程执行从单行到多行文本字符串的转换。 当上移或下移光标时，子例程将解释相对于输入方法的文本字符串上的光标位置。

此子例程由使用输入方法的应用程序提供。

参数

项 描述
IM 指示输入方法实例。
方向 指定向上或向下。
游标 指定新的光标位置或-1。
UData 指定由 IMCreate 子例程传递的参数。

返回值

如果发生错误，那么 IMTextCursor 子例程将返回 IMError 全局变量。 否则，将返回 IMNoError 值。