IInkCollector：：SetGestureStatus 方法 (msinkaut.h)

  • 發行項

修改已知手勢中物件或控件的興趣。

語法

HRESULT SetGestureStatus(
  [in] InkApplicationGesture Gesture,
  [in] VARIANT_BOOL          Listen
);

參數

[in] Gesture

您想要設定狀態的手勢。

[in] Listen

VARIANT_TRUE 表示正在使用手勢，或忽略手勢時 VARIANT_FALSE 。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 成功。
E_POINTER
 參數包含無效的指標。
E_INK_INVALID_MODE
 InkCollector 收集模式必須處於手勢模式。
E_INK_EXCEPTION
 發生例外狀況。
TPC_S_TRUNCATED
 不支援的手勢。
E_INVALIDARG
 旗標無效。
E_OUTOFMEMORY
 無法配置記憶體作業。

備註

若要在已知的手勢中取得物件或控件的興趣，請呼叫 GetGestureStatus 方法。

InkEdit 控制件不支援IAG_AllGestures手勢標識碼，並傳回錯誤。 傳遞無效的筆勢標識碼不會傳回 InkEdit 的錯誤，但 InkCollector、 InkOverlay 和 InkPicture 會失敗。

針對 InkEdit 控制件，只有當 Status 屬性傳回 IES_Idle時，才應該呼叫此方法。

規格需求

需求 值
最低支援的用戶端 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 msinkaut.h
程式庫 InkObj.dll

另請參閱

手勢事件

GetGestureStatus 方法

IInkCollector

InkApplicationGesture 列舉

InkCollector 類別