WM_POINTERCAPTURECHANGED メッセージ
入力ポインターのキャプチャが失われるウィンドウに送信されます。
ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。
#define WM_POINTERCAPTURECHANGED 0x024C
パラメーター
-
wParam
-
失われている入力ポインターに関する情報が含まれます。 ポインター ID を取得するには 、GET_POINTERID_WPARAM を使用します。
-
lParam
-
入力ポインターをキャプチャしているウィンドウへのハンドルが含まれます。 ポインターがウィンドウによってキャプチャされなくなった場合、この値は NULL にすることができます。
このメッセージが内部処理から生成される場合、値はメッセージを受信するウィンドウのハンドルになります。
戻り値
アプリケーションでこのメッセージを処理する場合は、0 を返す必要があります。
アプリケーションがこのメッセージを処理しない場合は、 DefWindowProc を呼び出す必要があります。
注釈
ウィンドウでは、この通知を使用して後続のメッセージの処理を停止し、ポインターが失われるのに必要なクリーンアップを開始する必要があります。 ポインターに関連付けられているジェスチャの処理も終了し (たとえば、 StopInteractionContext を呼び出して)、残りの連絡先をウィンドウに再関連付けする必要があります。
通常、ウィンドウが WM_POINTERCAPTURECHANGED 通知を受信した場合、入力ポインターに関連する後続の通知は受信されません。 このため、 WM_POINTERENTER や WM_POINTERLEAVEなどのペアの通知には依存しません。
WM_POINTERCAPTURECHANGED には POINTER_INFOデータは 含まれません。 設定されているPOINTER_FLAG_CAPTURECHANGED フラグ以外に、GetPointerInfo (または任意のバリアント) によって返されるデータは、通知の前に返されたデータと同じです。
アプリケーションがこの通知を処理しない場合、 DefWindowProc は 1 つ以上 のWM_GESTURE メッセージを生成するか、ジェスチャが認識されない場合は 、DefWindowProc がマウス入力を生成する可能性があります。
アプリケーションがポインター入力を選択的に使用し、残りを DefWindowProc に渡すと、結果の動作は未定義になります。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2012 [デスクトップ アプリのみ] |
| Header |
|