InkEdit 控件参考
使用 InkEdit 控件可以收集墨迹、识别墨迹以及将墨迹显示为文本。 此控件允许启用智能表单,从而提高文本输入的准确性。
此控件是 RichEdit 控件的超集。 它扩展 了 RichEdit 控件,能够捕获、识别和显示墨迹。
可以通过在 C++ 中调用 CoCreateInstance 方法来实例化此对象。
) 设置 WS_EX_TRANSPARENT 属性的 GroupBox 等透明 (控件后创建 InkEdit 控件将阻止 InkEdit 收集墨迹。
成员
枚举 | 描述 |
---|---|
AppearanceConstants | 定义值,这些值指定控件是平面显示还是三维显示。 |
BorderStyleConstants | 定义指定控件是否具有边框的值。 |
InkApplicationGesture | 定义在一组特定于应用程序的手势中设置兴趣的值。 |
InkDisplayMode | 定义值,该值指定所选内容是显示为墨迹还是文本。 |
InkEditStatus | 定义指定 InkEdit 控件是空闲、收集墨迹还是识别墨迹的值。 |
InkInsertMode | 定义指定墨迹插入 InkEdit 控件的方式的值。 |
InkMode | 定义指定绘制墨迹的收集模式设置的值-无论是禁用墨迹收集、收集墨迹还是收集墨迹和手势。 |
InkMouseButton | 定义指定按下的鼠标按钮的值。 |
InkMousePointer | 定义指定出现的鼠标指针类型的值。 |
MouseButton | 定义指定按下的鼠标按钮的值。 |
ScrollBarsConstants | 定义指定 InkEdit 控件滚动条在屏幕上的显示方式的值。 |
SelAlignmentConstants | 定义值,该值指定段落相对于 InkEdit 控件边距的对齐方式。 |
事件通知消息 | 说明 |
---|---|
IECN_STROKE | 当笔划 (Win32 仅) 完成时,将通过WM_NOTIFY消息发送此消息。 |
IECN_GESTURE | 当手势仅在 win32) (完成时,将通过WM_NOTIFY消息发送。 |
IECN_RECOGNITIONRESULT | 当识别仅) (Win32 时,此消息通过WM_NOTIFY消息发送。 |
事件 | 说明 |
---|---|
改变 | 当控件的内容或属性值发生更改时发生。 |
点击 | 在单击控件时发生。 |
DblClick | 在双击控件时发生。 |
手势 | 在识别应用程序手势时发生。 |
KeyDown | 当用户在 InkEdit 控件具有焦点时按键时发生。 |
KeyPress | 当 InkEdit 控件具有焦点时按下某个键时发生。 |
KeyUp | 在 InkEdit 控件具有焦点时释放键时发生。 |
MouseDown | 当鼠标指针位于 InkEdit 控件上并按下鼠标按钮时发生。 |
MouseMove | 当鼠标指针移到 InkEdit 控件上时发生。 |
MouseUp | 当鼠标指针位于 InkEdit 控件上并且松开鼠标按钮时发生。 |
RecognitionResult | 当 InkEdit 控件手动从 对 Recognize 方法的调用获取结果时或在触发识别超时后自动获取结果时发生。 |
SelChange | 当 InkEdit 控件中的墨迹选择发生更改时发生。 |
笔划 | 当用户在任何 IInkTablet 对象上绘制新的 IInkStrokeDisp 对象时发生。 |
获取/设置消息 | 说明 |
---|---|
EM_GETINKMODE | 获取控件的墨迹模式 (Win32 仅) 。 |
EM_SETINKMODE | 将控件的墨迹模式设置为仅) Win32 (。 |
EM_GETINKINSERTMODE | 获取控件的墨迹插入模式, (Win32 仅) 。 |
EM_SETINKINSERTMODE | 将控件的墨迹插入模式设置为仅) win32 (。 |
EM_GETDRAWATTR | 获取控件的当前绘图属性, (Win32 仅) 。 |
EM_SETDRAWATTR | 设置要用于未来墨迹集合的绘图属性 (Win32 仅) 。 |
EM_GETRECOTIMEOUT | 获取控件的识别超时 (Win32 仅) 。 |
EM_SETRECOTIMEOUT | 设置控件的识别超时 (Win32 仅) 。 |
EM_GETGESTURESTATUS | 获取控件的手势状态, (Win32 仅) 。 |
EM_SETGESTURESTATUS | 仅在 Win32) (设置控件的手势状态。 |
EM_GETRECOGNIZER | 获取控件仅) (Win32 使用的识别器。 |
EM_SETRECOGNIZER | 设置控件仅) (Win32 使用的识别器。 |
EM_GETFACTOID | 获取用于仅) Win32 (识别的 factoid。 |
EM_SETFACTIOD | 设置仅) 用于识别 (Win32 的自体。 |
EM_GETSELINK | 获取所选内容中的墨迹 (Win32 仅) 。 |
EM_SETSELINK | 仅) 设置所选内容中的墨迹 (Win32。 |
EM_GETSELINKDISPLAYMODE | 通过使用 InkDisplayMode 枚举的值之一,返回所选区域中墨迹的当前外观, (Win32 仅) 。 |
EM_SETSELINKDISPLAYMODE | 通过使用 InkDisplayMode 枚举的值之一设置所选区域中墨迹的外观, (Win32 仅) 。 |
EM_GETSTATUS | 仅获取 win32) (控件的状态。 |
EM_RECOGNIZE | 仅) 强制识别 (Win32。 |
EM_GETMOUSEICON | 获取仅) (Win32 的鼠标图标。 |
EM_SETMOUSEICON | 仅) 设置鼠标图标 (Win32。 |
EM_GETMOUSEPOINTER | 获取仅) (Win32 的鼠标指针。 |
EM_SETMOUSEPOINTER | 仅设置鼠标指针 Win32) 。 |
EM_GETUSEMOUSEFORINPUT | 获取是否将鼠标输入视为仅) win32 (笔输入的状态。 |
EM_SETUSEMOUSEFORINPUT | 设置是否将鼠标输入视为仅) win32 (笔输入的状态。 |
方法 | 说明 |
---|---|
GetGestureStatus | 获取 InkEdit 控件在一组已知手势中的兴趣。 |
Recognize | 指定应进行识别。 |
刷新 | 使控件重绘。 |
SetGestureStatus | 设置 InkEdit 控件在一组已知手势中的兴趣。 |
属性 | 说明 |
---|---|
外观 | 获取或设置一个值,该值确定 InkEdit 控件是显示平面还是三维。 |
BackColor | 获取或设置 InkEdit 控件的背景色。 |
BorderStyle | 获取或设置一个值,该值确定 InkEdit 控件是否具有边框。 |
DisableNoScroll | 获取或设置一个值,该值确定是否禁用 InkEdit 控件中的滚动条。 |
DrawingAttributes | 获取或设置尚未在 InkEdit 控件上绘制的墨迹的绘图属性。 |
Enabled | 获取或设置一个值,该值确定 InkEdit 控件是否可以响应用户生成的事件。 |
Factoid | 获取或设置 IInkRecognizer 对象用来约束其对识别结果的搜索的 Factoid 常量。 |
字体 | 获取或设置 InkEdit 控件显示的文本的字体。 |
hWnd | 获取 InkDisp 控件绑定到的窗口句柄。 |
InkInsertMode | 获取或设置一个值,该值指定如何将墨迹作为文本或墨迹插入到 InkEdit 控件上。 |
InkMode | 获取或设置一个值,该值指定是禁用墨迹收集、收集墨迹还是收集墨迹和笔势。 |
锁 | 获取或设置一个值,该值指定 InkEdit 控件是否为只读。 |
MaxLength | 获取或设置一个值,该值指示 InkEdit 控件是否可以容纳最大字符数,如果是,则指定最大字符数。 |
MouseIcon | 获取或设置当前自定义鼠标图标。 |
MousePointer | 获取或设置一个值,该值指示鼠标悬停在 InkEdit 控件的特定部分时出现的鼠标指针的类型。 |
MultiLine | 获取或设置一个值,该值指示这是否是多行 InkEdit 控件。 |
RecognitionTimeout | 获取或设置收集的最后 一个 IInkStrokeDisp 对象与文本识别开始之间的时间长度(以毫秒为单位)。 |
识别器 | 获取或设置用于识别的 IInkRecognizer 对象。 |
ScrollBars | 获取或设置 InkEdit 控件中显示的滚动条的类型。 |
SelAlignment | 获取或设置应用于当前选定内容或插入点的对齐方式, (运行时仅) 。 |
SelBold | 获取或设置一个值,该值指定 InkEdit 控件中当前选定文本的字体样式是否为粗体 (运行时仅) 。 |
SelCharOffset | 获取或设置 InkEdit 控件中的文本是在基线上显示为上标还是下标, (运行时仅) 。 |
SelColor | 获取或设置仅) 运行时 (当前文本选择或插入点的文本颜色。 |
SelFontName | 获取或设置 InkEdit 控件中选定文本的字体名称, (运行时仅) 。 |
SelFontSize | 获取或设置仅在) 运行时 (InkEdit 控件中选定文本的字号。 |
SelInks | 获取或设置嵌入的 InkDisp 对象的数组, (显示为当前所选内容包含的墨迹) 。 |
SelInksDisplayMode | 获取或设置一个值,该值允许在墨迹和文本之间切换所选内容的外观。 |
SelItalic | 获取或设置一个值,该值指定 InkEdit 控件中当前选定文本的字体样式是否为斜体 (运行时仅) 。 |
SelLength | 获取或设置仅在) 运行时 (InkEdit 控件中选择的字符数。 |
SelRTF | 获取或设置当前选定的 RTF 格式 (RTF) 仅在运行时) 的 InkEdit 控件 (格式的文本。 |
SelStart | 获取或设置文本框中所选文本的起始点, (运行时仅) 。 |
SelText | 获取或设置仅在) 运行时 (InkEdit 控件中的选定文本。 |
SelUnderline | 获取或设置一个值,该值指定 InkEdit 控件中当前选定文本的字体样式是否 (运行时仅) 带下划线。 |
状态 | 获取一个值,该值指定 InkEdit 控件是否处于空闲状态、收集墨迹或仅识别墨迹 (运行时) 。 |
文本 | 获取或设置文本框中的当前文本。 |
TextRTF | 获取或设置 InkEdit 控件的文本,包括所有 RTF 代码。 |
UseMouseForInput | 获取或设置一个值,该值指示鼠标是否可用作输入设备。 |
结构 | 说明 |
---|---|
IEC_STROKEINFO | 仅包含有关 Stroke 事件的信息 (Win32) 。 |
IEC_GESTUREINFO | 仅包含有关特定手势的信息, (Win32) 。 |
IEC_RECOGNITIONRESULTINFO | 包含有关仅) win32 (识别结果的信息。 |
COM 实现
此对象实现 IInkEdit COM 接口。