IInkPicture::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 的錯誤,但 InkCollectorInkOverlayInkPicture 失敗

針對 InkEdit 控制項,只有在 Status 屬性傳回 IES_Idle時,才應該呼叫這個方法。

規格需求

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

另請參閱

手勢事件

GetGestureStatus 方法

IInkPicture

InkApplicationGesture 列舉

InkPicture