IInkCollector：:p ut_CollectionMode 方法 (msinkaut.h)
取得或設定集合模式，判斷筆跡、手勢或兩者是否辨識為使用者寫入。
這是可讀寫的屬性。
語法
HRESULT put_CollectionMode(
InkCollectionMode Mode
);
參數
Mode
傳回值
無
備註
如需您可以使用的模式清單，請參閱 InkCollectionMode 列舉類型。 不過，在已安裝 Microsoft Windows XP Tablet PC Edition 軟體發展工具組的系統上使用 CollectionMode 屬性 (SDK) 但未安裝辨識器時，模式無法設定為 GestureOnly 或 InkAndGesture。
注意如果您嘗試在收集 Ink 時變更CollectionMode屬性，InkCollector物件、InkOverlay物件或InkPicture控制項會產生錯誤。 若要避免此衝突，請先檢查 CollectionInk 屬性，再變更 CollectionMode 屬性。
InkOnly 模式
- 只會收集筆跡;手勢不是。
- 筆勢事件興趣會設定為FALSE， (所有其他事件興趣都會維持) 。
GestureOnly 模式
- 只會收集手勢;筆跡不是。 筆劃會在傳送至手勢辨識器之後刪除。
- 筆勢事件興趣會設定為TRUE， (所有其他事件興趣都會維持) 。
- 筆跡收集器不會引發下列筆劃和封包相關事件： CursorDown、 Stroke、 NewPackets和 NewInAirPackets 事件。
- 引發資料指標事件。
- 一律會刪除筆跡。
- 會收集筆跡和手勢。
- 只會辨識單一筆劃手勢。
- 筆勢事件興趣會設定為TRUE， (所有其他事件興趣都會維持) 。
- 手勢事件會先引發，讓您接受或取消手勢。 若要取消手勢，請將 Cancel 參數設定為 TRUE。 取消手勢會強制筆跡收集器收集筆跡。
當 CollectionMode 設定為 InkAndGesture 且已知手勢的物件/控制項興趣設定 (為 setGestureStatus 方法時，可能會發生不必要的行為，方法是呼叫 SetGestureStatus 方法) 。 如果您繪製類似已知手勢的筆跡，且已知手勢位於辨識器的替代清單中， 則即使筆勢 不是頂端替代專案，筆勢事件也會引發，筆跡也會消失。 若要防止筆跡消失並取消筆勢的集合，如果事件是您不感興趣的事件，請將 Cancel 參數設定為 TRUE 。
當 CollectionMode 設定為 GestureOnly時，當使用者新增手勢時和 Gesture 事件發生之間的逾時，是無法以程式設計方式改變的固定值。 筆勢辨識在 InkAndGesture 模式中較快。 若要防止 在 InkAndGesture 模式中收集筆跡，您可以：
- 將 CollectionMode 屬性設定為 InkAndGesture。
- 在 Stroke 事件中，刪除筆劃。
- 在 Gesture 事件中，處理筆勢。
- 將 DynamicRendering 設定為 FALSE ，以防止筆跡在擷取時流動。
需求
| 最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | msinkaut.h |
| 程式庫 | InkObj.dll |