InkCollectionMode 列挙 (msinkaut.h)

  • [アーティクル]

ユーザーの書き込み時にインク、ジェスチャ、またはインクとジェスチャを認識するかどうかを決定する値を定義します。

構文

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

定数

 
ICM_InkOnly
値: 0
インクのみを収集し、ストロークを作成します。

Gesture イベントのインタレストは FALSE に設定されています。つまり、ジェスチャは収集されません (他のすべてのイベントの関心は、そのまま残ります)。
ICM_GestureOnly
ジェスチャのみを収集し、ストロークを作成しません。 ジェスチャは、単一ストロークでも複数ストロークでもかまいません。 認識エンジンの組み込みタイマーによって設定された時間内にストロークが行われた場合、マルチストローク ジェスチャが受け入れられます。

ストロークに関連するすべてのイベントとパケット関連のイベントは、 InkCollector から発生しません。 カーソル イベントが発生し、インクは常に削除されます。

Gesture イベントのインタレストは TRUE に設定されています。つまり、ジェスチャが収集されます (他のすべてのイベントの関心は、そのまま残ります)。
ICM_InkAndGesture
シングル ストローク ジェスチャのみを受け入れます。 Gesture イベントが最初に発生し、ユーザーは Cancel = TRUE または FALSE と言える機能が提供されます。 NoGesture がプライマリ ジェスチャである場合を除き、既定値は TRUE です。Cancel の既定値は FALSE です。 TRUE の場合、インクはジェスチャであり、削除されます。 FALSE の場合、ジェスチャはインクであり、Stroke イベントが発生します。

Gesture イベントのインタレストは TRUE に設定されます (他のすべてのイベントの関心は、そのまま保持されます)。

注釈

InkOnly モードまたは InkAndGesture モードのときにユーザーが右クリックを試み、ペンを移動すると、ペン先からインクが流れます。 Stroke イベントを処理するときは、ペンの動きの結果として流れたインクを消去する必要があります。

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

Microsoft Windows XP Tablet PC Edition ソフトウェア開発キット (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 に設定します。

要件

要件 値
サポートされている最小のクライアント Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
Header msinkaut.h

こちらもご覧ください

CollectionMode プロパティ [InkCollector クラス]

ジェスチャ イベント

InkCollector クラス

InkOverlay クラス

InkPicture コントロール リファレンス

Stroke イベント