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