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 モードでインクが収集されないようにするには、次の手順を実行します。
- CollectionMode を InkAndGesture に設定します。
- Stroke イベントで、ストロークを削除します。
- Gesture イベントで、ジェスチャを処理します。
- DynamicRendering を FALSE に設定します。
インク コレクターは常にストローク (InkOnly モード) またはジェスチャ (GestureOnly モード) を作成し、両方 (InkAndGesture モード) を作成する場合があります。
各モードの一般的なシナリオは次のとおりです。
- InkOnly:
- CursorInRange イベントが発生します。
- NewInAirPackets イベントが発生します。
- CursorDown イベントが発生します。
- NewPackets イベントが発生します。
- IInkStrokeDisp オブジェクトが作成されます。
- CursorOutOfRange イベントが発生します。
メモCursorOutOfRange イベントを発生させる必要がない場合があります。 インクの描画を続行する場合は、ストロークの完了後に NewInAirPackets または CursorDown イベントに戻ります。 - GestureOnly:
- CursorInRange イベントが発生します。
- NewInAirPackets イベントが発生します。
- CursorDown イベントが発生します。
- NewPackets イベントが発生します。
- IInkGesture オブジェクトが作成されるか、カーソルの移動がジェスチャを表さない場合は何も起こりません。
- CursorOutOfRange イベントが発生します。
メモ このモードでは、シングルストロークジェスチャまたはマルチストロークジェスチャを使用できます。 - InkAndGesture:
- CursorInRange イベントが発生します。
- NewInAirPackets イベントが発生します。
- CursorDown イベントが発生します。
- NewPackets イベントが発生します。
- IInkGesture オブジェクトまたは IInkStrokeDisp オブジェクトが作成されます。
- CursorOutOfRange イベントが発生します。
メモ このモードでは、シングルストローク ジェスチャのみが受け入れられます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| Header | msinkaut.h |