CollectionMode 枚举

项目
11/04/2008

定义一些值，这些值确定在用户书写时识别墨迹、笔势还是同时识别两者。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Enumeration CollectionMode
用法
Dim instance As CollectionMode

public enum CollectionMode

public enum class CollectionMode

public enum CollectionMode

public enum CollectionMode

成员

	成员名称	说明
	InkOnly	仅收集墨迹，创建笔画。InkCollector.Gesture、InkOverlay.Gesture 或 InkPicture.Gesture 事件关注设置为 false，表示不收集笔势（所有其他事件关注保持不变）。
	GestureOnly	仅收集笔势而不创建笔画。笔势可以是单笔画笔势，也可以是多笔画笔势。如果笔画在识别器的内置计时器所设置的时间内完成，则接受多笔画笔势。InkCollector 对象、InkOverlay 对象或 InkPicture 控件中不激发与笔画相关和与数据包相关的所有事件。将激发光标事件，总是删除墨迹。InkCollector.Gesture、InkOverlay.Gesture 或 InkPicture.Gesture 事件关注设置为 true，表示收集笔势（所有其他事件关注保持不变）。
	InkAndGesture	仅接受单笔画笔势。首先激发 InkCollector.Gesture、InkOverlay.Gesture 或 InkPicture.Gesture 事件，您可以取消或接受该事件。默认设置是接受该事件，当 ApplicationGesture 中的 NoGesture 值是主要笔势时除外。如果接受笔势，则删除墨迹。如果取消笔势，则不删除笔画，并且激发 InkCollector.Stroke、InkOverlay.Stroke 或 InkPicture.Stroke 事件。InkCollector.Gesture、InkOverlay.Gesture 或 InkPicture.Gesture 事件关注设置为 true，表示收集笔势（所有其他事件关注保持不变）。

备注

如果用户在 InkOnly 或 InkAndGesture 模式下尝试右键单击并移动笔，墨迹将从笔尖流出。处理 InkCollector.Stroke、InkOverlay.Stroke 或 InkPicture.Stroke 事件时，将擦除因笔的移动而流出的墨迹。

当 InkCollector.CollectionMode、InkOverlay.CollectionMode 或 InkPicture.CollectionMode 属性设置为 GestureOnly 时，则从用户添加笔势到发生 InkCollector.Gesture、InkOverlay.Gesture、InkPicture.Gesture 事件之间的超时是一个不能以编程方式更改的固定值。在 InkAndGesture 模式中，笔势识别的速度更快。若要禁止在 InkAndGesture 模式下收集墨迹，您可以：

将收集模式设置为 InkAndGesture。
在 InkCollector.Stroke、InkOverlay.Stroke 或 InkPicture.Stroke 的处理程序中删除笔画。
在笔势事件的处理程序中处理笔势。
将 InkCollector.DynamicRendering、InkOverlay.DynamicRendering 或 InkPicture.DynamicRendering 属性设置为 false。

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

每种收集模式的典型方案如下。

备注

如果光标不移出收集对象在笔画之间的范围，则不激发光标在范围中和光标超出范围事件。

InkOnly

步骤	InkCollector 对象	InkOverlay 对象	InkPicture 控件
1	激发 CursorInRange 事件。	激发 CursorInRange 事件。	激发 CursorInRange 事件。
2	激发 NewInAirPackets 事件。	激发 NewInAirPackets 事件。	激发 NewInAirPackets 事件。
3	激发 CursorDown 事件。	激发 CursorDown 事件。	激发 CursorDown 事件。
4	激发 NewPackets 事件。	激发 NewPackets 事件。	激发 NewPackets 事件。
5	创建 Stroke 对象。	创建 Stroke 对象。	创建 Stroke 对象。
6	激发 CursorOutOfRange 事件。	激发 CursorOutOfRange 事件。	激发 CursorOutOfRange 事件。

GestureOnly

步骤	InkCollector 对象	InkOverlay 对象	InkPicture 控件
1	激发 CursorInRange 事件。	激发 CursorInRange 事件。	激发 CursorInRange 事件。
2	激发 NewInAirPackets 事件。	激发 NewInAirPackets 事件。	激发 NewInAirPackets 事件。
3	激发 CursorDown 事件。	激发 CursorDown 事件。	激发 CursorDown 事件。
4	激发 NewPackets 事件。	激发 NewPackets 事件。	激发 NewPackets 事件。
5	创建 Gesture 对象；或者，如果光标移动不表示笔势，则不发生任何操作。	创建 Gesture 对象；或者，如果光标移动不表示笔势，则不发生任何操作。	创建 Gesture 对象；或者，如果光标移动不表示笔势，则不发生任何操作。
6	激发 CursorOutOfRange 事件。	激发 CursorOutOfRange 事件。	激发 CursorOutOfRange 事件。

备注

此模式接受单笔画笔势和多笔画笔势。

InkAndGesture

步骤	InkCollector 对象	InkOverlay 对象	InkPicture 控件
1	激发 CursorInRange 事件。	激发 CursorInRange 事件。	激发 CursorInRange 事件。
2	激发 NewInAirPackets 事件。	激发 NewInAirPackets 事件。	激发 NewInAirPackets 事件。
3	激发 CursorDown 事件。	激发 CursorDown 事件。	激发 CursorDown 事件。
4	激发 NewPackets 事件。	激发 NewPackets 事件。	激发 NewPackets 事件。
5	创建 Gesture 对象或 Stroke 对象。	创建 Gesture 对象或 Stroke 对象。	创建 Gesture 对象或 Stroke 对象。
6	激发 CursorOutOfRange 事件。	激发 CursorOutOfRange 事件。	激发 CursorOutOfRange 事件。

备注

此模式仅接受单笔画笔势。

如果 InkCollector.CollectionMode、InkOverlay.CollectionMode 或 InkPicture.CollectionMode 属性设置为，并且设置了对象或控件对某个已知笔势的关注（通过调用 InkCollector.SetGestureStatus、InkOverlay.SetGestureStatus 或 InkPicture.SetGestureStatus 方法），可能发生意外行为。如果用户绘制的墨迹与识别器备选项列表中的墨迹相似，则会激发笔势事件且墨迹会消失，即使该笔势不是排在最前面的备选项也如此。若要防止墨迹消失并取消笔势收集，请将 InkCollectorGestureEventArgs 的继承的 Cancel 属性设置为 true（如果您不希望识别器响应该事件）。