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
Winuser.h (Windows.h を含む)

関連項目

Messages (メッセージ)