CollectionMode 列舉型別

發行項
10/29/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。

在已安裝 Microsoft® Windows® XP Tablet PC Edition 軟體開發套件 (SDK) 但未安裝辨識器的系統上，將這個列舉型別與 InkPicture 控制項或與 InkCollector 或 InkOverlay 物件搭配使用時，模式不能設定為 GestureOnly 或 InkAndGesture。

每個收集模式的典型情況如下。

注意事項：
如果游標未移出筆劃間之集合物件的範圍外，則不會引發範圍內的游標事件和範圍外的游標事件。

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 (如果您不要辨識器回應該事件的話)。