iInkCollector：：get_CollectionMode 方法 (msinkaut.h)
获取或设置收集模式，该模式确定在用户写入时是否识别墨迹和/或笔势。
此属性是可读写的。
语法
HRESULT get_CollectionMode(
InkCollectionMode *Mode
);
参数
Mode
返回值
无
备注
有关可以使用的模式的列表，请参阅 InkCollectionMode 枚举类型。 但是，在安装了 Microsoft Windows XP 平板电脑版软件开发工具包 (SDK) 但未安装识别器的系统上使用 CollectionMode 属性时，该模式不能设置为 GestureOnly 或 InkAndGesture。
注意如果在收集墨迹时尝试更改 CollectionMode 属性，InkCollector 对象、InkOverlay 对象或 InkPicture 控件将生成错误。 若要避免此冲突，请在更改 CollectionMode 属性之前检查 CollectionInk 属性。
InkOnly 模式
- 仅收集墨迹;手势不是。
- 手势事件兴趣设置为 FALSE (所有其他事件兴趣保持为) 。
GestureOnly 模式
- 仅收集手势;墨迹不是。 笔划在发送到笔势识别器后将被删除。
- 手势事件兴趣设置为 TRUE， (所有其他事件兴趣保持) 。
- 墨迹收集器不会触发以下笔划和数据包相关事件： CursorDown、 Stroke、 NewPackets 和 NewInAirPackets 事件。
- 游标事件触发。
- 始终删除墨迹。
- 同时收集墨迹和手势。
- 仅识别单笔笔划手势。
- 手势事件兴趣设置为 TRUE， (所有其他事件兴趣保持) 。
- 首先触发手势事件，允许你接受或取消手势。 若要取消手势，请将 Cancel 参数设置为 TRUE。 取消手势会强制墨迹收集器收集墨迹。
当 CollectionMode 设置为 InkAndGesture ，并通过调用 SetGestureStatus 方法) (设置对象/控件对已知手势的兴趣时，可能会出现不需要的行为。 如果绘制的墨迹看起来类似于已知手势，并且已知手势位于识别器备用项列表中，则 即使笔势 不是顶部替代项，手势事件也会触发并消失。 若要防止墨迹消失并取消笔势的集合，请将 Cancel 参数设置为 TRUE （如果事件是你不感兴趣的事件）。
当 CollectionMode 设置为 GestureOnly 时，用户添加手势和 手势事件发生之间的 超时是一个无法以编程方式更改的固定值。 在 InkAndGesture 模式下，手势识别速度更快。 若要防止在 InkAndGesture 模式下收集墨迹，可以：
- 将 CollectionMode 属性设置为 InkAndGesture。
- 在 Stroke 事件中，删除笔划。
- 在 “手势” 事件中，处理手势。
- 将 DynamicRendering 设置为 FALSE ，以防止在手势时墨迹流动。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP Tablet PC Edition [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | msinkaut.h |
| Library | InkObj.dll |