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 属性。
 
每个 CollectionMode 值都发生以下行为：

InkOnly 模式

  • 仅收集墨迹;手势不是。
  • 手势事件兴趣设置为 FALSE (所有其他事件兴趣保持为) 。

GestureOnly 模式

  • 仅收集手势;墨迹不是。 笔划在发送到笔势识别器后将被删除。
  • 手势事件兴趣设置为 TRUE， (所有其他事件兴趣保持) 。
  • 墨迹收集器不会触发以下笔划和数据包相关事件： CursorDown、 Stroke、 NewPackets 和 NewInAirPackets 事件。
  • 游标事件触发。
  • 始终删除墨迹。

InkAndGesture 模式

  • 同时收集墨迹和手势。
  • 仅识别单笔笔划手势。
  • 手势事件兴趣设置为 TRUE， (所有其他事件兴趣保持) 。
  • 首先触发手势事件，允许你接受或取消手势。 若要取消手势，请将 Cancel 参数设置为 TRUE。 取消手势会强制墨迹收集器收集墨迹。
更改收集模式不会更改单个手势的状态。

当 CollectionMode 设置为 InkAndGesture ，并通过调用 SetGestureStatus 方法) (设置对象/控件对已知手势的兴趣时，可能会出现不需要的行为。 如果绘制的墨迹看起来类似于已知手势，并且已知手势位于识别器备用项列表中，则 即使笔势 不是顶部替代项，手势事件也会触发并消失。 若要防止墨迹消失并取消笔势的集合，请将 Cancel 参数设置为 TRUE （如果事件是你不感兴趣的事件）。

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

  1. 将 CollectionMode 属性设置为 InkAndGesture。
  2. 在 Stroke 事件中，删除笔划。
  3. 在 “手势” 事件中，处理手势。
  4. 将 DynamicRendering 设置为 FALSE ，以防止在手势时墨迹流动。

要求

要求 值
最低受支持的客户端 Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 msinkaut.h
Library InkObj.dll

另请参阅

CollectingInk 属性

Enabled 属性

IInkCollector

InkCollectionMode 枚举

InkCollector 类