InkCollectionMode Enumeration

Defines values that determine whether ink, gestures, or ink and gestures are recognized as the user writes.

Declaration

[C++]

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

[Microsoft® Visual Basic® 6.0]

Enum InkCollectionMode
    ICM_InkOnly = 0
    ICM_GestureOnly = 1
    ICM_InkAndGesture = 2
End Enum

Members

The following tables list the enumeration values.

Remarks

If a user attempts a right-click and moves the pen when in InkOnly or InkAndGesture mode, ink flows from the pen tip. When handling the Stroke event, you should erase the ink that flowed as a result of the pen movement.

When the CollectionMode is set to GestureOnly (set through the CollectionMode property), the timeout between when a user adds a gesture and when the Gesture event occurs is a fixed value that cannot be altered programmatically. Gesture recognition is faster in InkAndGesture mode. To prevent the collection of ink while in InkAndGesture mode, you can:

• Set CollectionMode to InkAndGesture.
• In the Stroke event, delete the stroke.
• In the Gesture event, process the gesture.
• Set DynamicRendering to False.

When using this enumeration with the InkPicture control, or the InkCollector or InkOverlay objects, on a system that has the Microsoft Windows® XP Tablet PC Edition Software Development Kit (SDK) installed but that doesn't have recognizers, the mode cannot be set to GestureOnly or InkAndGesture.

The ink collector always creates either a stroke (InkOnly mode) or a gesture (GestureOnly mode) and sometimes created both (InkAndGesture mode).

Typical scenarios for each mode follow.

• InkOnly:
  1. CursorInRange event fires.
  2. NewInAirPackets event fires.
  3. CursorDown event fires.
  4. NewPackets event fires.
  5. IInkStrokeDisp object is created.
  6. CursorOutOfRange event fires. Note: You may not always want to fire the CursorOutOfRange event. If you want to continue drawing ink, you may return to the NewInAirPackets or CursorDown events after a stroke is completed.
• GestureOnly:
  1. CursorInRange event fires.
  2. NewInAirPackets event fires.
  3. CursorDown event fires.
  4. NewPackets event fires.
  5. Either a IInkGesture object is created or, if the cursor movement does not represent a gesture, nothing happens.
  6. CursorOutOfRange event fires. Note: Either single or multi-stroke gestures are accepted in this mode.
• InkAndGesture:
  1. CursorInRange event fires.
  2. NewInAirPackets event fires.
  3. CursorDown event fires.
  4. NewPackets event fires.
  5. Either a IInkGesture object or a IInkStrokeDisp object is created.
  6. CursorOutOfRange event fires. Note: Only single-stroke gestures are accepted in this mode.

Unwanted behavior might occur when the CollectionMode property is set to InkAndGesture and the interest of an object or control in a known gesture is set (by calling the SetGestureStatus method). If a user draws ink that resembles a gesture that is in the recognizer's list of alternates, the Gesture event fires and ink disappears, even if the gesture is not the top alternate. To prevent the ink from disappearing and cancel collection of the gesture, set Cancel to True if the event is one to which you do not want the recognizer to respond.

Related Topics

• InkCollector Object (Automation Library Reference)
• InkOverlay Object (Automation Library Reference)
• InkPicture Control (Automation Library Reference)
• CollectionMode Property
• Gesture Event
• Stroke Event