InkCollectionMode

ユーザーが書いている間に、インク、ジェスチャ、またはインクとジェスチャの両方のいずれを認識するかを決定する値を定義します。

InkOnly モードまたは InkAndGesture モードで、ユーザーが右クリックを試みてペンを動かすと、ペン先からインクが流れます。Stroke イベントを処理する際は、ペンの移動によって流れたインクを消去してください。

InkCollectionMode が GestureOnly に設定されている場合 (CollectionMode プロパティで設定します)、ユーザーがジェスチャを行ってから Gesture イベントが発生するまでのタイムアウトは固定値であり、プログラムから変更することはできません。ジェスチャの認識は InkAndGesture モードの方が高速です。InkAndGesture モードでインクの収集を防ぐには、次のようにします。

• CollectionMode を InkAndGesture に設定します。
• Stroke イベントでストロークを削除します。
• Gesture イベントでジェスチャを処理します。
• DynamicRendering を FALSE に設定します。

Microsoft Windows XP Tablet PC Edition Software Development Kit (SDK) はインストールされているものの認識エンジンが存在しないシステムで、この列挙型を InkPicture コントロール (または InkCollector オブジェクトや InkOverlay オブジェクト) と共に使用する場合、モードを GestureOnly または InkAndGesture に設定することはできません。

インク コレクターは、常にストローク (InkOnly モード) またはジェスチャ (GestureOnly モード) のいずれかを作成し、場合によっては両方を作成します (InkAndGesture モード)。

各モードの代表的なシナリオを次に示します。

• InkOnly:
  1. CursorInRange イベントが発生します。
  2. NewInAirPackets イベントが発生します。
  3. CursorDown イベントが発生します。
  4. NewPackets イベントが発生します。
  5. IInkStrokeDisp オブジェクトが作成されます。
  6. CursorOutOfRange イベントが発生します。
  メモ  CursorOutOfRange イベントを常に発生させたいとは限りません。インクの描画を続ける場合は、ストロークの完了後に NewInAirPackets イベントまたは CursorDown イベントに戻ることができます。
   
• GestureOnly:
  1. CursorInRange イベントが発生します。
  2. NewInAirPackets イベントが発生します。
  3. CursorDown イベントが発生します。
  4. NewPackets イベントが発生します。
  5. IInkGesture オブジェクトが作成されます。カーソルの動きがジェスチャを表していない場合は、何も起こりません。
  6. CursorOutOfRange イベントが発生します。
  メモ  このモードでは、単一ストロークと複数ストロークのどちらのジェスチャも受け付けられます。
   
• InkAndGesture:
  1. CursorInRange イベントが発生します。
  2. NewInAirPackets イベントが発生します。
  3. CursorDown イベントが発生します。
  4. NewPackets イベントが発生します。
  5. IInkGesture オブジェクトまたは IInkStrokeDisp オブジェクトが作成されます。
  6. CursorOutOfRange イベントが発生します。
  メモ  このモードでは、単一ストロークのジェスチャのみが受け付けられます。
   

CollectionMode プロパティが InkAndGesture に設定されていて、既知のジェスチャに対するオブジェクトまたはコントロールの関心が (SetGestureStatus メソッドの呼び出しによって) 設定されている場合、望ましくない動作が発生することがあります。認識エンジンの認識候補の一覧に含まれるジェスチャに似たインクをユーザーが描画すると、そのジェスチャが最上位の候補でなくても Gesture イベントが発生し、インクが消えます。インクが消えないようにしてジェスチャの収集を取り消すには、認識エンジンに応答させたくないイベントの場合に Cancel を TRUE に設定します。

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

public enum InkCollectionMode : int
{
    ICM_InkOnly = 0,
    ICM_GestureOnly = 1,
    ICM_InkAndGesture = 2,
}

Public Enum InkCollectionMode As Integer
    ICM_InkOnly = 0
    ICM_GestureOnly = 1
    ICM_InkAndGesture = 2
End Enum

import enum

class InkCollectionMode(enum.IntEnum):
    ICM_InkOnly = 0
    ICM_GestureOnly = 1
    ICM_InkAndGesture = 2

// InkCollectionMode
pub const ICM_InkOnly: i32 = 0;
pub const ICM_GestureOnly: i32 = 1;
pub const ICM_InkAndGesture: i32 = 2;

// InkCollectionMode
const (
	ICM_InkOnly int32 = 0
	ICM_GestureOnly int32 = 1
	ICM_InkAndGesture int32 = 2
)

const
  ICM_InkOnly = 0;
  ICM_GestureOnly = 1;
  ICM_InkAndGesture = 2;

// InkCollectionMode
pub const ICM_InkOnly: i32 = 0;
pub const ICM_GestureOnly: i32 = 1;
pub const ICM_InkAndGesture: i32 = 2;

const
  ICM_InkOnly* = 0
  ICM_GestureOnly* = 1
  ICM_InkAndGesture* = 2

enum InkCollectionMode : int {
    ICM_InkOnly = 0,
    ICM_GestureOnly = 1,
    ICM_InkAndGesture = 2,
}

#define global ICM_InkOnly       0x0
#define global ICM_GestureOnly   0x1
#define global ICM_InkAndGesture 0x2