InkEdit 消息 (Win32 仅)
InkEdit 控件是 RichEdit 控件的超级类。 在大多数情况下,每个 RichEdit 消息都是直接传递的,其效果与 RichEdit 中完全相同。 这也适用于事件通知消息。
若要发送这些消息,请使用以下参数调用 SendMessage 函数:
C++ |
---|
|
消息
InkEdit 控件的父窗口通过WM_NOTIFY消息接收事件通知消息:
LRESULT CALLBACK WindowProc(
HWND hWnd, // handle to window
UINT uMsg, // WM_NOTIFY
WPARAM wParam, // InkEdit control identifier
LPARAM lParam // see documentation for notification messages
);
获取/设置消息 | 说明 |
---|---|
EM_GETINKMODE |
获取 InkEdit 控件的墨迹书写模式。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 此消息返回 InkMode 枚举中定义的值之一,该值指定是否禁用墨迹收集、是否收集墨迹或手势。 |
EM_SETINKMODE |
设置 InkEdit 控件的墨迹书写模式。 参数: wParam指定 InkMode 枚举的值之一,该值指定是禁用墨迹收集、是否收集墨迹,还是收集墨迹和笔势。 lParam不使用此参数;它必须为 0。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 备注: 仅当EM_GETSTATUS返回IES_Idle时,才应使用此选项。 |
EM_GETINKINSERTMODE |
获取 InkEdit 控件的墨迹 插入模式。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 此消息返回 InkInsertMode 枚举的值之一,该枚举指定是将墨迹作为文本还是墨迹插入控件。 |
EM_SETINKINSERTMODE |
设置 InkEdit 控件的墨迹 插入模式。 如果与除 Microsoft Windows XP Tablet PC Edition 以外的任何操作系统一起使用,则发送此消息不起作用。 参数: wParam指定 InkInsertMode 枚举的值之一,该枚举指定墨迹是作为文本还是墨迹插入控件。 lParam不使用此参数;它必须为 0。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETDRAWATTR |
获取 InkEdit 控件的当前绘图属性。 参数: wParam不使用此参数;它必须为 0。 lParam指定一个指针 (IInkDrawingAttributes **pDrawAttr) 接收当前 InkDrawingAttributes 对象。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_SETDRAWATTR |
设置要用于将来墨迹集合的绘图属性。 参数: wParam不使用此参数;它必须为 0。 lParam指定指向 InkDrawingAttributes 对象的 (IInkDrawingAttributes *pDrawAttr) 的指针。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETRECOTIMEOUT |
获取 InkEdit 控件的识别超时(以毫秒为单位)。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 此消息返回识别超时(以毫秒为单位)。 |
EM_SETRECOTIMEOUT |
设置 InkEdit 控件的识别超时(以毫秒为单位)。 参数: wParam指定识别超时(以毫秒为单位)。 lParam不使用此参数;它必须为 0。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETGESTURESTATUS |
获取 InkEdit 控件的手势状态。 参数: wParam指定笔势的类型,如 InkApplicationGesture 枚举中定义。 lParam不使用此参数;它必须为 0。 返回值: 如果 InkEdit 控件订阅手势,则此消息返回 TRUE;如果 InkEdit 控件不订阅该手势,则返回 FALSE。 |
EM_SETGESTURESTATUS |
设置 InkEdit 控件的手势状态。 参数: wParam指定笔势的类型,如 InkApplicationGesture 枚举中定义。 lParam如果启用订阅手势,则指定 TRUE ;如果未启用侦听手势,则指定 FALSE 。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 备注: 仅当EM_GETSTATUS返回IES_Idle时,才应使用此选项。 |
EM_GETRECOGNIZER |
获取 InkEdit 控件使用的识别器。 参数: wParam不使用此参数;它必须为 0。 lParam指定指向 IInkRecognizer* 的指针,以接收 InkEdit 控件使用的 IInkRecognizer 对象。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_SETRECOGNIZER |
设置 InkEdit 控件使用的识别器。 如果将 Factoid 用于 InkEdit 控件,则必须在发送此消息后重新应用它。 参数: wParam不使用此参数;它必须为 0。 lParam指定指向 IInkRecognizer* 的指针,以设置 InkEdit 控件用于以后使用的 IInkRecognizer 对象。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 备注: 仅当EM_GETSTATUS返回IES_Idle时,才应使用此函数。 |
EM_GETFACTOID |
获取用于识别的 Factoid 。 参数: wParam不使用此参数;它必须为 0。 lParam指定指向 BSTR 的指针以接收事实字符串。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_SETFACTOID |
设置用于识别的 Factoid 。 参数: wParam不使用此参数;它必须为 0。 lParam指定包含事实字符串的 BSTR。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 备注: 仅当EM_GETSTATUS返回IES_Idle时,才应使用此函数。 |
EM_GETSELINK |
获取所选内容中的墨迹。 必须先识别墨迹,然后才能通过此消息访问。 如果未首先识别它,EM_GETSELINK始终返回零 个 InkDisp 对象。 参数: wParam不使用此参数;它必须为 0。 lParam指定指向 VARIANT 的指针,以接收安全数组以接收当前所选内容中的 InkDisp 对象。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_SETSELINK |
设置所选内容中的墨迹。 如果与除 Windows XP Tablet PC Edition 之外安装的任何操作系统一起使用,则发送此消息无效。 参数: wParam不使用此参数;它必须为 0。 lParam指定指向 VARIANT 的指针,其中包含用于替换当前选定内容的 InkDisp 对象的安全数组。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETSELINKDISPLAYMODE |
通过使用 InkDisplayMode 枚举的值之一,返回所选区域中墨迹的当前外观。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 此消息返回 InkDisplayMode 枚举 (IDM_Text或IDM_Ink) 的值之一,该值指定所选内容在控件上的显示方式。 |
EM_SETSELINKDISPLAYMODE |
使用 InkDisplayMode 枚举的值之一设置所选区域中墨迹的外观。 参数: wParam不使用此参数;它必须为 0。 lParam指定墨迹在所选区域中的显示方式,如 InkDisplayMode 枚举中定义。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 如果与除 Windows XP Tablet PC Edition 之外安装的任何操作系统一起使用,则发送此消息无效。 |
EM_GETSTATUS |
获取 InkEdit 控件的状态。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 此消息返回 InkEditStatus 枚举的值之一,该值指定控件是空闲、收集墨迹还是识别墨迹。 |
EM_RECOGNIZE |
强制识别。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETMOUSEICON |
获取鼠标图标。 参数: wParam不使用此参数;它必须为 0。 lParam指定使用当前 MouseIcon HICON 填充的 HICON* 指针。 此 HICON 可以是 HICON 或 NULL 值。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_SETMOUSEICON |
设置鼠标图标。 参数: wParam指定一个 BOOLEAN 值,如果 InkEdit 控件应拥有 HICON 句柄,则设置为 TRUE;如果 InkEdit 控件不应拥有 HICON 句柄,则设置为 FALSE。 如果 InkEdit 控件拥有 HICON,则它会相应地处理并销毁 HICON。 否则,调用方拥有 HICON 并负责删除它。 lParam指定新的 HICON 值。 使用 NULL 清除值。 默认值为 NULL。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETMOUSEPOINTER |
获取鼠标指针。 参数: wParam不使用此参数;它必须为 0。 lParam包含用当前 MousePointer 值填充的 InkMousePointer * 指针。 其行为与 InkCollector::get_MousePointer 属性相同。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_SETMOUSEPOINTER |
设置鼠标指针。 参数: wParam不使用此参数;它必须为 0。 lParam包含新的 MousePointer 值,该值在 InkMousePointer 枚举中定义。 其行为与 InkCollector::p ut_MousePointer 属性相同。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 |
EM_GETUSEMOUSEFORINPUT |
获取是否将鼠标输入视为笔输入的状态。 参数: 此消息没有参数; wParam 和 lParam 必须为 0。 返回值: 如果 为 FALSE ,则此消息返回 0;如果 为 TRUE,则返回 1。 |
EM_SETUSEMOUSEFORINPUT |
设置是否将鼠标输入视为笔输入的状态。 参数: wParam指定一个布尔值,该值确定是否将鼠标输入视为笔输入。 lParam不使用此参数;它必须为 0。 返回值: 如果成功,则此消息返回 0;如果发生错误,则返回非零。 备注: 仅当EM_GETSTATUS返回IES_Idle时,才应使用此函数。 |
事件通知消息 | 说明 |
---|---|
IECN_STROKE |
通知 InkEdit 控件的父窗口已创建 IInkStrokeDisp 。 这会在WM_NOTIFY消息中使用以下参数发送。 参数: wParam指定发送消息的控件的标识符。 lParam指定指向 IEC_STROKEINFO 结构的指针。 返回值: 客户端返回 0 以接受笔划,返回 1 以取消笔划。 |
IECN_GESTURE |
通知 InkEdit 控件的父窗口已识别手势。 这会在WM_NOTIFY消息中使用以下参数发送。 参数: wParam指定发送消息的控件的标识符。 lParam指定指向 IEC_GESTUREINFO 结构的指针。 返回值: 客户端返回 0 以接受手势,返回 1 以取消手势。 |
IECN_RECOGNITIONRESULT |
通知 InkEdit 控件的父窗口已发生识别。 这会在WM_NOTIFY消息中使用以下参数发送。 参数: wParam指定发送消息的控件的标识符。 lParam指定指向 IEC_RECOGNITIONRESULTINFO 结构的指针。 返回值: 如果客户端处理消息,则返回 0。 |