InkCollectionMode 列舉 (msinkaut.h)

發行項
03/05/2024

定義值，判斷筆跡、手勢或筆跡和筆勢是否可辨識為使用者寫入。

Syntax

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

常數


`ICM_InkOnly` 值： 0 只收集筆跡，建立筆劃。 Gesture 事件興趣設定為 FALSE，這表示不會在所有其他事件興趣 (收集手勢，因為它們) 。
`ICM_GestureOnly` 只收集手勢，而且不會建立筆劃。手勢可以是單一或多筆劃。如果筆劃是在辨識器內建定時器所設定的時間內進行，則會接受多筆劃手勢。所有筆劃相關和封包相關事件都不會從 InkCollector 引發。數據指標事件會引發，而且一律會刪除筆跡。 Gesture 事件興趣設定為 TRUE，這表示會收集手勢， (所有其他事件興趣維持在) 時。
`ICM_InkAndGesture` 只接受單筆劃手勢。手勢事件會先引發，讓用戶能夠說出 Cancel = TRUE 或 FALSE。默認值為 TRUE，除了 NoGesture 是主要手勢時， Cancel 預設為 FALSE。如果為 TRUE，則筆跡是筆勢，且已刪除。如果為 FALSE，則筆勢為筆跡，而且會引發 Stroke 事件。手勢事件興趣會設定為 TRUE， (所有其他事件興趣都會保留為) 。

備註

如果使用者嘗試單擊滑鼠右鍵，並在 InkOnly 或 InkAndGesture 模式中移動手寫筆，則筆跡會從筆尖流動。處理 Stroke 事件時，您應該清除因手寫筆移動而流動的筆跡。

當 InkCollectionMode 設定為 GestureOnly (透過 CollectionMode 屬性設定) 時，當使用者新增手勢時和 Gesture 事件發生之間的逾時，是無法以程式設計方式改變的固定值。筆勢辨識在 InkAndGesture 模式中較快。若要防止在 InkAndGesture 模式中收集筆跡，您可以：

將 CollectionMode 設定為 InkAndGesture。
在 Stroke 事件中，刪除筆劃。
在 Gesture 事件中，處理筆勢。
將 DynamicRendering 設定為 FALSE。

搭配 InkPicture 控件使用這個列舉時， (或 InkCollector 或 InkOverlay 物件) 在已安裝 Microsoft Windows XP Tablet PC Edition 軟體開發工具包的系統上 (SDK) 但沒有辨識器，則模式無法設定為 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 方法) 。如果使用者繪製的筆跡類似於辨識器辨識替代專案清單中的筆跡，則即使筆勢不是頂端替代專案，筆勢事件也會引發，筆跡也會消失。若要防止筆跡消失並取消筆勢的集合，如果事件是您不想讓辨識器回應的事件，請將 Cancel 設定為 TRUE 。