IInkOverlay：:p ut_CollectionMode 方法 (msinkaut.h)

取得或設定集合模式，判斷筆跡、手勢或兩者是否辨識為使用者寫入。

這是可讀寫的屬性。

語法

HRESULT put_CollectionMode(
  InkCollectionMode Mode
);

參數

Mode

傳回值

無

備註

如需您可以使用的模式清單，請參閱 InkCollectionMode 列舉類型。 不過，在具有 Microsoft Windows 的系統上使用 CollectionMode 屬性時？ 已安裝 XP Tablet PC Edition 軟體開發工具包 (SDK) 但未安裝辨識器，模式無法設定為 GestureOnly 或 InkAndGesture。

InkOnly 模式

• 只會收集筆跡;手勢不是。
• 筆勢事件興趣會設定為 FALSE， (所有其他事件興趣都會維持) 。

GestureOnly 模式

• 只會收集手勢;筆跡不是。 筆劃會在傳送至手勢辨識器之後刪除。
• 筆勢事件興趣會設定為TRUE， (所有其他事件興趣都會維持) 。
• 筆跡收集器不會引發下列筆劃和封包相關事件： CursorDown、 Stroke、 NewPackets 和 NewInAirPackets 事件。
• 引發數據指標事件。
• 一律會刪除筆跡。

InkAndGesture 模式

• 會收集筆跡和手勢。
• 只會辨識單一筆劃手勢。
• 筆勢事件興趣會設定為TRUE， (所有其他事件興趣都會維持) 。
• 手勢事件會先引發，讓您接受或取消手勢。 若要取消手勢，請將 Cancel 參數設定為 TRUE。 取消手勢會強制筆跡收集器收集筆跡。

當 CollectionMode 設定為 InkAndGesture 且已知手勢的物件/控件興趣設定 (為 setGestureStatus 方法時，可能會發生不必要的行為，方法是呼叫 SetGestureStatus 方法) 。 如果您繪製類似已知手勢的筆跡，且已知手勢位於辨識器的替代清單中， 則即使筆勢 不是頂端替代專案，筆勢事件也會引發，筆跡也會消失。 若要防止筆跡消失並取消筆勢的集合，如果事件是您不感興趣的事件，請將 Cancel 參數設定為 TRUE 。

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

1. 將 CollectionMode 屬性設定為 InkAndGesture。
2. 在 Stroke 事件中，刪除筆劃。
3. 在 Gesture 事件中，處理筆勢。
4. 將 DynamicRendering 設定為 FALSE ，以防止筆跡在擷取時流動。

規格需求

另請參閱

CollectingInk 屬性

Enabled 屬性

IInkOverlay

InkCollectionMode 列舉

InkOverlay 類別