IInkOverlay：:p ut_CollectionMode 方法 (msinkaut.h)
获取或设置收集模式，该模式确定是否在用户写入时识别墨迹和/或手势。
此属性是可读写的。
语法
HRESULT put_CollectionMode(
InkCollectionMode Mode
);
参数
Mode
返回值
无
备注
有关可使用的模式的列表，请参阅 InkCollectionMode 枚举类型。 但是，在具有 Microsoft Windows 的系统上使用 CollectionMode 属性时？ XP Tablet PC Edition 软件开发工具包 (SDK) 安装，但未安装识别器，该模式不能设置为 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 |