指定したポインターとインク ストロークを手書きエクスペリエンスに使用することを要求します。
構文
HRESULT RequestHandwritingForPointer(
[in] UINT32 pointerId,
[in] UINT64 handwritingStrokeId,
[out] BOOL *requestAccepted,
[out] ITfHandwritingRequest **request
);
パラメーター
[in] pointerId
ポインター識別子。
[in] handwritingStrokeId
インク ストローク識別子。
getHandwritingStrokeIdForPointer を呼び出して、WM_POINTERDOWN メッセージによって開始されたストロークの一意の ID を取得する必要があります。
[out] requestAccepted
要求が受け入れられた場合は True。それ以外の場合は false。
[out] request
ITfHandwritingRequest オブジェクトへのポインター。
戻り値
メソッドが成功すると、 S_OKが返されます。 失敗した場合は、 HRESULT エラー コードが返されます。
注釈
このメソッドは、 pointerId の 現在の手書き状態が TF_HANDWRITING_POINTERDELIVERY に設定されている 場合、または TF_USE_POINTER_DELIVERY が手書きの近接コールバックへの応答である場合にのみ呼び出すことができます。それ以外の場合は、E_INVALIDARGを返します。
このメソッドは、pointerId のWM_POINTERDOWN メッセージを受信してから 2 秒以内に呼び出す必要があります。 この 2 秒間にこのメソッドが呼び出されない場合、S_OKが返されますが、 requestAccepted は false に設定されます。
要件
| Header | shellhandwriting.h |