メッセージ
このセクションのトピックでは、特定の ポインター入力メッセージと通知のリファレンス仕様について説明します。
このセクションの内容
| トピック | 説明 |
|---|---|
|
DM_POINTERHITTEST |
直接操作の最も可能性の高い入力ターゲットを決定するために、ポインター入力が最初に検出されたときにウィンドウに送信されます。 |
|
WM_NCPOINTERDOWN |
ポインターがウィンドウのクライアント以外の領域に接触したときに投稿されます。 メッセージは、ポインターが接触するウィンドウを対象とします。 ポインターは暗黙的にウィンドウにキャプチャされるため、ウィンドウは接触を中断するまでポインターの入力を受け取り続けます。 ウィンドウがこのポインターをキャプチャした場合、このメッセージは投稿されません。 代わりに、このポインターをキャプチャしたウィンドウに WM_POINTERDOWN がポストされます。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_NCPOINTERUP |
ウィンドウのクライアント以外の領域に接触したポインターが連絡先を切断したときに投稿されます。 このメッセージは、ポインターが接触するウィンドウをターゲットにし、ポインターがその時点で暗黙的にウィンドウにキャプチャされるため、ウィンドウは、 WM_NCPOINTERUP 通知を含め、連絡先を中断するまでポインターの入力を受け取り続けます。 ウィンドウがこのポインターをキャプチャした場合、このメッセージは投稿されません。 代わりに、このポインターをキャプチャしたウィンドウに WM_POINTERUP がポストされます。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_NCPOINTERUPDATE |
ウィンドウのクライアント以外の領域に接触したポインター、またはホバーしているキャプチャされていない連絡先がウィンドウのクライアント以外の領域に移動したときに、ポインターに更新を提供するように投稿されます。 ポインターがポイントされている間、メッセージはポインターが重なるウィンドウをターゲットにします。 ポインターがサーフェスに接触している間は、ポインターが接触したウィンドウにポインターが暗黙的にキャプチャされ、そのウィンドウはポインターの入力を受け取り続け、接触が切断されるまでポインターの入力を受け取ります。 ウィンドウがこのポインターをキャプチャした場合、このメッセージは投稿されません。 代わりに、このポインターをキャプチャしたウィンドウに WM_POINTERUPDATE がポストされます。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_PARENTNOTIFY |
子孫ウィンドウで重要なアクションが発生したときに、ウィンドウに送信されます。 このメッセージは、 WM_POINTERDOWN イベントを含むように拡張されました。 子ウィンドウが作成されると、システムは、ウィンドウを作成する CreateWindow 関数または CreateWindowEx関数の直前にWM_PARENTNOTIFYを送信します。 子ウィンドウが破棄されると、システムは、ウィンドウを破棄する処理が行われる前にメッセージを送信します。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_POINTERACTIVATE |
プライマリ ポインターがウィンドウ上に WM_POINTERDOWN を生成すると、非アクティブなウィンドウに送信されます。 メッセージがハンドルされない限り、最上位ウィンドウに到達するまで親ウィンドウ チェーンを上に移動します。 アプリケーションはこのメッセージに応答して、アクティブ化するかどうかを指定できます。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 |
|
WM_POINTERCAPTURECHANGED |
入力ポインターのキャプチャが失われるウィンドウに送信されます。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 |
|
WM_POINTERDEVICECHANGE |
デジタイザーが接続されているモニターの設定に変更がある場合に、ウィンドウに送信されます。 このメッセージには、表示モードのスケーリングに関する情報が含まれています。 |
|
WM_POINTERDEVICEINRANGE |
入力デジタイザーの範囲内でポインター デバイスが検出されると、ウィンドウに送信されます。 このメッセージには、デバイスとその近接性に関する情報が含まれています。 |
|
WM_POINTERDEVICEOUTOFRANGE |
ポインター デバイスが入力デジタイザーの範囲を逸脱したときにウィンドウに送信されます。 このメッセージには、デバイスとその近接性に関する情報が含まれています。 |
|
WM_POINTERDOWN |
ポインターがウィンドウのクライアント領域に接触したときに投稿されます。 この入力メッセージは、ポインターが接触するウィンドウを対象とし、ポインターは暗黙的にウィンドウにキャプチャされるため、ウィンドウは接触を中断するまでポインターの入力を受け取り続けます。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_POINTERENTER |
新しいポインターがウィンドウの上に検出範囲に入ったとき (ホバー)、または既存のポインターがウィンドウの境界内を移動したときに、ウィンドウに送信されます。 |
|
WM_POINTERLEAVE |
ポインターがウィンドウの上に検出範囲を離れる (ホバー) か、ポインターがウィンドウの境界の外に移動したときに、ウィンドウに送信されます。 |
|
WM_POINTERROUTEDAWAY |
ポインター入力が別のプロセスにルーティングされるときに、入力を受け取るプロセスで発生します。 |
|
WM_POINTERROUTEDRELEASED |
現在のプロセスでWM_POINTERUP メッセージを受信したときに、特定のポインター ID に関連付けられたすべてのプロセス (AddContentWithCrossProcessChaining を介してクロスプロセス チェーン用に構成され、現在ポインター入力を処理していない) に送信されます。 |
|
WM_POINTERROUTEDTO |
既存のポインター ID に対してポインター入力が進行中の場合に送信され、クロスプロセス チェーン用に構成されたコンテンツ間で 1 つのプロセスから別のプロセスに遷移します (AddContentWithCrossProcessChaining)。 |
|
WM_POINTERUP |
ウィンドウのクライアント領域に接触したポインターが連絡先を切断したときに投稿されます。 この入力メッセージは、ポインターが接触し、その時点でポインターが暗黙的にウィンドウにキャプチャされるウィンドウを対象としているため、ウィンドウは、ポインターに対する WM_POINTERUP 通知を含む入力メッセージを受信し続け、接触を中断します。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_POINTERUPDATE |
ウィンドウのクライアント領域に接触したポインター、またはウィンドウのクライアント領域の上にカーソルを合わせたキャプチャされていないポインターに更新を提供するように投稿されます。 ポインターがポイントされている間、メッセージはポインターが重なるウィンドウをターゲットにします。 ポインターがサーフェスに接触している間は、ポインターが接触したウィンドウにポインターが暗黙的にキャプチャされ、そのウィンドウはポインターの入力を受け取り続け、接触が切断されるまでポインターの入力を受け取ります。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_POINTERWHEEL |
スクロール ホイールが回転したときに、前景キーボード フォーカスを使用してウィンドウに投稿されます。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_POINTERHWHEEL |
水平スクロール ホイールが回転したときに、前景キーボード フォーカスを使用してウィンドウに投稿されます。 ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。 重要: デスクトップ アプリは DPI 対応である必要があります。 アプリが DPI に対応していない場合、DPI 仮想化により、ポインター メッセージと関連する構造体に含まれる画面座標が不正確に見える可能性があります。 DPI 仮想化では、DPI 対応ではなく、既定でアクティブになっているアプリケーションに対して自動スケーリングのサポートが提供されます (ユーザーはそれをオフにすることができます)。 詳細については、「 高 DPI Win32 アプリケーションの作成」を参照してください。 |
|
WM_TOUCHHITTESTING |
最も可能性の高いタッチ ターゲットを決定するために、タッチダウン時にウィンドウに送信されます。 |