CollectionMode 列挙体
インクとジェスチャのどちらが (またはその両方が) ユーザーの書き込みとして認識されるかを決定する値を定義します。
名前空間 : 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 に設定します。
InkPicture コントロール、InkCollector オブジェクト、または InkOverlay オブジェクトと共にこの列挙体を使用するときに、システムに Microsoft® Windows® XP Tablet PC Edition Software Development Kit (SDK) がインストールされているけれども認識エンジンがインストールされていない場合は、モードを GestureOnly または InkAndGesture に設定することはできません。
各収集モードの一般的なシナリオを次に示します。
メモ : |
---|
ストロークとストロークの間にカーソルがコレクション オブジェクトの範囲外に移動しない場合は、CursorInRange イベントと CursorOutRange イベントは発生しません。 |
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
6
CursorOutOfRange イベントが発生します。
CursorOutOfRange イベントが発生します。
CursorOutOfRange イベントが発生します。
メモ : このモードでは、単一ストローク ジェスチャだけが受け入れられます。
InkCollector.CollectionMode プロパティ、InkOverlay.CollectionMode プロパティ、または InkPicture.CollectionMode プロパティが設定されている場合に、オブジェクトまたはコントロールの対象が既知のジェスチャであることが設定されると (設定するには InkCollector.SetGestureStatus メソッド、InkOverlay.SetGestureStatus メソッド、または InkPicture.SetGestureStatus メソッドを呼び出す)、望ましくない動作が発生することがあります。ユーザーが描画したインクが、認識エンジンの代替候補のリストにあるジェスチャに似ている場合は、そのジェスチャが最上位代替候補かどうかを問わず、ジェスチャ イベントが発生してインクが消えます。インクが消えることを回避し、ジェスチャの収集をキャンセルするには、InkCollectorGestureEventArgs の継承された Cancel プロパティを true に設定することで、認識エンジンがそのイベントに応答しないように設定します。
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0