CollectionMode 列挙体

[アーティクル]
10/28/2008

インクとジェスチャのどちらが (またはその両方が) ユーザーの書き込みとして認識されるかを決定する値を定義します。

名前空間 : 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	Gesture オブジェクトまたは Stroke オブジェクトのどちらかが作成されます。	Gesture オブジェクトまたは Stroke オブジェクトのどちらかが作成されます。	Gesture オブジェクトまたは Stroke オブジェクトのどちらかが作成されます。
6	CursorOutOfRange イベントが発生します。	CursorOutOfRange イベントが発生します。	CursorOutOfRange イベントが発生します。

メモ :
このモードでは、単一ストロークジェスチャだけが受け入れられます。

InkCollector.CollectionMode プロパティ、InkOverlay.CollectionMode プロパティ、または InkPicture.CollectionMode プロパティが設定されている場合に、オブジェクトまたはコントロールの対象が既知のジェスチャであることが設定されると (設定するには InkCollector.SetGestureStatus メソッド、InkOverlay.SetGestureStatus メソッド、または InkPicture.SetGestureStatus メソッドを呼び出す)、望ましくない動作が発生することがあります。ユーザーが描画したインクが、認識エンジンの代替候補のリストにあるジェスチャに似ている場合は、そのジェスチャが最上位代替候補かどうかを問わず、ジェスチャイベントが発生してインクが消えます。インクが消えることを回避し、ジェスチャの収集をキャンセルするには、InkCollectorGestureEventArgs の継承された Cancel プロパティを true に設定することで、認識エンジンがそのイベントに応答しないように設定します。