InkCollectionMode 枚举 (msinkaut.h)

项目
08/24/2023

定义用于确定是否在用户写入时识别墨迹、笔势或墨迹和笔势的值。

语法

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

常量


`ICM_InkOnly` 值： 0 仅收集墨迹，创建笔划。手势事件兴趣设置为 FALSE，这意味着不会收集手势， (所有其他事件兴趣保持) 。
`ICM_GestureOnly` 仅收集手势，不创建笔划。手势可以是单笔划或多笔划。如果在识别器内置计时器设置的时间内进行笔划，则接受多笔划手势。所有与笔划相关的事件和与数据包相关的事件都不会从 InkCollector 触发。游标事件会触发，并且始终删除墨迹。手势事件兴趣设置为 TRUE，这意味着将收集手势， (所有其他事件兴趣保持) 。
`ICM_InkAndGesture` 仅接受单笔划手势。首先触发手势事件，使用户能够说“取消 TRUE = ”或“FALSE”。默认值为 TRUE，除非 NoGesture 是主要手势，取消默认为 FALSE。如果为 TRUE，则墨迹是手势并被删除。如果为 FALSE，则手势为墨迹，并触发 Stroke 事件。手势事件兴趣设置为 TRUE， (所有其他事件兴趣都保留为) 。

注解

如果用户尝试右键单击并在 InkOnly 或 InkAndGesture 模式下移动笔，墨迹会从笔尖流出。处理 Stroke 事件时，应擦除由于笔移动而流动的墨迹。

当 InkCollectionMode 设置为 GestureOnly (通过 CollectionMode 属性) 设置时，用户添加手势和手势事件发生之间的超时是一个固定值，无法以编程方式更改。在 InkAndGesture 模式下，手势识别速度更快。若要防止在 InkAndGesture 模式下收集墨迹，可以：

将 CollectionMode 设置为 InkAndGesture。
在 Stroke 事件中，删除笔划。
在 “手势” 事件中，处理手势。
将 DynamicRendering 设置为 FALSE。

将此枚举与 InkPicture 控件 (或 InkCollector 或 InkOverlay 对象一起使用时，在安装了 Microsoft Windows XP Tablet PC Edition 软件开发工具包 (SDK) 但没有识别器的系统上) InkCollector 或 InkOverlay 对象时，模式不能设置为 GestureOnly 或 InkAndGesture。

墨迹收集器始终创建笔划 (InkOnly 模式) 或手势 (GestureOnly 模式) ，有时 (InkAndGesture 模式) 创建。

每种模式的典型方案如下所示。

InkOnly：
1. CursorInRange 事件触发。
2. NewInAirPackets 事件触发。
3. CursorDown 事件触发。
4. NewPackets 事件将触发。
5. IInkStrokeDisp 对象已创建。
6. CursorOutOfRange 事件触发。
注意你可能并不总是想要触发 CursorOutOfRange 事件。如果要继续绘制墨迹，可以在笔划完成后返回到 NewInAirPackets 或 CursorDown 事件。
GestureOnly：
1. CursorInRange 事件触发。
2. NewInAirPackets 事件触发。
3. CursorDown 事件触发。
4. NewPackets 事件将触发。
5. 创建 IInkGesture 对象，或者，如果光标移动不表示手势，则不会发生任何操作。
6. CursorOutOfRange 事件触发。
注意在此模式下接受单笔划或多笔划手势。
InkAndGesture：
1. CursorInRange 事件触发。
2. NewInAirPackets 事件触发。
3. CursorDown 事件触发。
4. NewPackets 事件将触发。
5. 创建 IInkGesture 对象或 IInkStrokeDisp 对象。
6. CursorOutOfRange 事件触发。
注意在此模式下，仅接受单笔划手势。

当 CollectionMode 属性设置为 InkAndGesture 并且通过调用 SetGestureStatus 方法) (设置对象或控件在已知手势中的兴趣时，可能会出现不需要的行为。如果用户绘制的墨迹类似于识别器识别备用列表中的手势，则手势事件将触发并且墨迹消失，即使手势不是顶部替换。若要防止墨迹消失并取消手势的集合，请将 “取消 ”设置为 TRUE （如果事件是你不希望识别器响应的事件）。