InkEdit 消息 (Win32 仅)

InkEdit 控件是 RichEdit 控件的超级类。 在大多数情况下,每个 RichEdit 消息都是直接传递的,其效果与 RichEdit 中完全相同。 这也适用于事件通知消息。

若要发送这些消息,请使用以下参数调用 SendMessage 函数:

C++
LRESULT SendMessage(  HWND hWnd,      // handle to destination window  UINT Msg,       // message  WPARAM wParam,  // first message parameter  LPARAM lParam   // second message parameter);

消息

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 控件的墨迹书写模式。
参数:
此消息没有参数; wParamlParam 必须为 0。
返回值:
此消息返回 InkMode 枚举中定义的值之一,该值指定是否禁用墨迹收集、是否收集墨迹或手势。
EM_SETINKMODE
设置 InkEdit 控件的墨迹书写模式。
参数:
wParam指定 InkMode 枚举的值之一,该值指定是禁用墨迹收集、是否收集墨迹,还是收集墨迹和笔势。
lParam不使用此参数;它必须为 0。
返回值:
如果成功,则此消息返回 0;如果发生错误,则返回非零。
备注:
仅当EM_GETSTATUS返回IES_Idle时,才应使用此选项。
EM_GETINKINSERTMODE
获取 InkEdit 控件的墨迹 插入模式。
参数:
此消息没有参数; wParamlParam 必须为 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 控件的识别超时(以毫秒为单位)。
参数:
此消息没有参数; wParamlParam 必须为 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 枚举的值之一,返回所选区域中墨迹的当前外观。
参数:
此消息没有参数; wParamlParam 必须为 0。
返回值:
此消息返回 InkDisplayMode 枚举 (IDM_Text或IDM_Ink) 的值之一,该值指定所选内容在控件上的显示方式。
EM_SETSELINKDISPLAYMODE
使用 InkDisplayMode 枚举的值之一设置所选区域中墨迹的外观。
参数:
wParam不使用此参数;它必须为 0。
lParam指定墨迹在所选区域中的显示方式,如 InkDisplayMode 枚举中定义。
返回值:
如果成功,则此消息返回 0;如果发生错误,则返回非零。 如果与除 Windows XP Tablet PC Edition 之外安装的任何操作系统一起使用,则发送此消息无效。
EM_GETSTATUS
获取 InkEdit 控件的状态。
参数:
此消息没有参数; wParamlParam 必须为 0。
返回值:
此消息返回 InkEditStatus 枚举的值之一,该值指定控件是空闲、收集墨迹还是识别墨迹。
EM_RECOGNIZE
强制识别。
参数:
此消息没有参数; wParamlParam 必须为 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
获取是否将鼠标输入视为笔输入的状态。
参数:
此消息没有参数; wParamlParam 必须为 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。

应用于

仅 win32) (IEC_GESTUREINFO 结构

仅 win32) (IEC_STROKEINFO 结构

仅 win32) (IEC_RECOGNITIONRESULTINFO 结构

MousePointer 属性

InkEditStatus 枚举

InkInsertMode 枚举

InkMode 枚举

IInkCursor 接口

InkDrawingAttributes 类

IInkRecognitionResult 接口

IInkRecognizer 接口

InkDisp 类

IInkGesture 接口