ITfHandwriting::RequestHandwritingForPointer 方法 (shellhandwriting.h)
要求指定的指標和筆墨筆劃用於手寫體驗。
語法
HRESULT RequestHandwritingForPointer(
[in] UINT32 pointerId,
[in] UINT64 handwritingStrokeId,
[out] BOOL *requestAccepted,
[out] ITfHandwritingRequest **request
);
參數
[in] pointerId
指標識別碼。
[in] handwritingStrokeId
筆跡筆劃識別碼。
您必須呼叫 GetHandwritingStrokeIdForPointer ,以擷取 WM_POINTERDOWN 訊息所啟動之筆劃的唯一識別碼。
[out] requestAccepted
如果已接受要求,則為 True;否則為 false。
[out] request
ITfHandwritingRequest物件的指標。
傳回值
如果方法成功,它會 傳回S_OK。 如果失敗,則會傳回 HRESULT 錯誤碼。
備註
只有在 pointerId 目前的手寫狀態設定為 TF_HANDWRITING_POINTERDELIVERY 或 TF_USE_POINTER_DELIVERY 是手寫鄰近回呼的回應時,才能呼叫這個方法,否則會傳回E_INVALIDARG。
這個方法必須在收到pointerIdWM_POINTERDOWN訊息的兩秒內呼叫。 如果未在此兩秒的時間範圍內呼叫此方法,則會傳回S_OK,但 requestAccepted 會設定為 false。
規格需求
標頭 | shellhandwriting.h |