WM_POINTERUPDATE メッセージ

[アーティクル]
03/12/2025

ウィンドウのクライアント領域に接触したポインター、またはウィンドウのクライアント領域の上にカーソルを合わせたキャプチャされていないポインターの更新を提供するように投稿されます。ポインターがホバーしている間、メッセージはポインターが重なるウィンドウをターゲットにします。ポインターがサーフェスと接触している間、ポインターはポインターが接触したウィンドウに暗黙的にキャプチャされ、そのウィンドウは接触を中断するまでポインターの入力を受け取り続けます。

![重要]
デスクトップアプリは DPI に対応している必要があります。アプリが DPI 対応でない場合、DPI 仮想化により、ポインターメッセージおよび関連する構造に含まれる画面座標が不正確に表示されることがあります。 DPI 仮想化は、DPI 対応ではなく、既定でアクティブなアプリケーションに対して自動スケーリングのサポートを提供します (ユーザーは無効にすることができます)。詳細については、「Win32 アプリケーションHigh-DPI 書き込み」を参照してください。

#define WM_POINTERUPDATE              0x0245

パラメーター

wParam をする

ポインターに関する情報を格納します。 wParam パラメーターから情報を取得するには、次のマクロを使用します。

GET_POINTERID_WPARAM(wParam): ポインター識別子。
IS_POINTER_NEW_WPARAM(wParam): このメッセージが新しいポインターによって生成された最初の入力を表すかどうかを示すフラグ。
IS_POINTER_INRANGE_WPARAM(wParam): このメッセージがその有効期間中にポインターによって生成されたかどうかを示すフラグ。ポインターが検出範囲を離れたことを示すメッセージでは、このフラグは設定されません
IS_POINTER_INCONTACT_WPARAM(wParam): このメッセージがウィンドウサーフェイスに接触しているポインターによって生成されたかどうかを示すフラグ。このフラグは、ホバーポインターを示すメッセージには設定されません。
IS_POINTER_PRIMARY_WPARAM(wParam): このポインターがプライマリとして指定されていることを示します。
IS_POINTER_FIRSTBUTTON_WPARAM(wParam): プライマリアクションがあるかどうかを示すフラグ。
- これは、マウスの左ボタンの下に似ています。
- タッチポインターは、デジタイザーサーフェスと接触すると、このセットを持つことになります。
- ペンポインターは、ボタンが押されていないデジタイザーサーフェスと接触している場合に、このセットを持つことになります。
IS_POINTER_SECONDBUTTON_WPARAM(wParam): セカンダリアクションがあるかどうかを示すフラグ。
- これは、マウスの右ボタンの下に似ています。
- ペンポインターは、ペンバレルボタンが押された状態でデジタイザーサーフェスに接触している場合に、このセットを持つことになります。
IS_POINTER_THIRDBUTTON_WPARAM(wParam): ポインター型に基づいて 1 つ以上の 3 番目のアクションがあるかどうかを示すフラグ。3 次アクションに応答するアプリケーションでは、ポインターの種類に固有の情報を取得して、どの 3 番目のボタンが押されているかを判断する必要があります。たとえば、アプリケーションでは、GetPointerPenInfo呼び出し、ボタンの状態を指定するフラグを調べることで、ペンのボタンの状態を確認できます。
IS_POINTER_FOURTHBUTTON_WPARAM(wParam): 指定したポインターが 4 番目のアクションを実行したかどうかを示すフラグ。 4 番目のアクションに応答するアプリケーションは、ポインターの種類に固有の情報を取得して、最初の拡張マウス (XButton1) ボタンが押されているかどうかを判断する必要があります。
IS_POINTER_FIFTHBUTTON_WPARAM(wParam): 指定したポインターが 5 番目のアクションを実行したかどうかを示す フラグ。 5 番目のアクションに応答するアプリケーションでは、ポインターの種類に固有の情報を取得して、2 番目の拡張マウス (XButton2) ボタンが押されているかどうかを判断する必要があります。

詳細については、「ポインターフラグの」を参照してください。

手記

ホバーポインターには、どのボタンフラグも設定されていません。これは、マウスボタンを押さないマウス移動に似ています。アプリケーションは、たとえば、getPointerPenInfo呼び出し、ボタンの状態を指定するフラグを調べることによって、ホバーペンのボタンの状態を確認できます。

lParam

ポインターのポイント位置を格納します。

手記

ポインターは単純でない領域を介してデバイスと接触する可能性があるため、このポイント位置は、より複雑なポインター領域の簡略化になる可能性があります。可能な限り、アプリケーションではポイントの位置ではなく、完全なポインター領域情報を使用する必要があります。

ポイントの物理的な画面座標を取得するには、次のマクロを使用します。

GET_X_LPARAM(lParam): x (水平点) 座標。
GET_Y_LPARAM(lParam): y (垂直点) 座標。

戻り値

アプリケーションがこのメッセージを処理すると、0 が返されます。

アプリケーションがこのメッセージを処理しない場合は、DefWindowProc呼び出す必要があります。

備考

各ポインターは、有効期間中に一意のポインター識別子を持ちます。ポインターの有効期間は、最初に検出されたときに開始されます。

ホバーポインターが検出されると、WM_POINTERENTER メッセージが生成されます。ホバーしていないポインターが検出されると、WM_POINTERDOWN メッセージとそれに続く WM_POINTERENTER メッセージが生成されます。

ポインターの有効期間中に、ポインターがホバー中または接触中に一連の WM_POINTERUPDATE メッセージを生成する場合があります。

ポインターの有効期間は、ポインターが検出されなくなったときに終了します。これにより、WM_POINTERLEAVE メッセージが生成されます。

ポインターが中止されると、POINTER_FLAG_CANCELED が設定されます。

WM_POINTERLEAVE メッセージは、キャプチャされていないポインターがウィンドウの境界外に移動したときにも生成される場合があります。

ポインターの水平方向と垂直方向の位置を取得するには、次のコマンドを使用します。

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

MAKEPOINTS マクロを使用して、lParam パラメーターを POINTS 構造体に変換することもできます。

GetKeyState 関数を使用して、このメッセージに関連付けられているキーボード修飾子キーの状態を確認できます。たとえば、Alt キーが押されたことを検出するには、GetKeyState (VK_MENU) 0 < かどうかを確認します。

アプリケーションがこのメッセージを処理しない場合、defWindowProc、このメッセージからの入力シーケンスと、場合によっては他のポインターがジェスチャとして認識された場合に、1 つ以上の WM_GESTURE メッセージを生成する可能性があります。ジェスチャが認識されない場合、DefWindowProc マウス入力が生成される可能性があります。

アプリケーションがポインター入力を選択的に使用し、残りを DefWindowProc渡すと、結果の動作は未定義になります。

GetPointerInfo 関数を使用して、このメッセージに関連する詳細情報を取得します。

アプリケーションでこれらのメッセージが生成されるほど速く処理されない場合は、一部の移動が結合される可能性があります。このメッセージに結合された入力の履歴は、GetPointerInfoHistory 関数を使用して取得できます。

例

次のコード例は、GET_X_LPARAM、GET_Y_LPARAM、IS_POINTER_FIRSTBUTTON_WPARAM、および IS_POINTER_SECONDBUTTON_WPARAM を使用して、WM_POINTERUPDATE メッセージの wParam パラメーターと lParam パラメーターから関連情報を取得する方法を示しています。

int xPos = GET_X_LPARAM(lParam);
int yPos = GET_Y_LPARAM(lParam);

if (IS_POINTER_PRIMARYBUTTON_WPARAM(wParam))
{
    // process pointer move while down, similar to mouse move with left button down
}
else if (IS_POINTER_SECONDARYBUTTON_WPARAM(wParam))
{
    // process pointer move while down, similar to mouse move with right button down
}

次のコード例は、GET_POINTERID_WPARAM を使用して、WM_POINTERUPDATE メッセージの wParam パラメーターからポインター ID を取得する方法を示しています。

POINTER_INFO pointerInfo;
UINT32       pointerId = GET_POINTERID_WPARAM(wParam);

// Retrieve common pointer information
if (!GetPointerInfo(pointerId, &amp;pointerInfo))
{
    // failure, call GetLastError()
}
else
{
    // success, process pointerInfo
}

次のコード例は、さまざまなポインター型を処理する方法を示しています。

POINTER_TOUCH_INFO   touchInfo;
POINTER_PEN_INFO     penInfo;
POINTER_INFO pointerInfo;
UINT32       pointerId = GET_POINTERID_WPARAM(wParam);
POINTER_INPUT_TYPE pointerType = PT_POINTER;

// default to unhandled to enable call to DefWindowProc
fHandled = FALSE;

if (!GetPointerType(pointerId, &pointerType))
{
    // failure, call GetLastError()
    // set PT_POINTER to fall to default case below
    pointerType = PT_POINTER;
}

switch (pointerType)
{
case PT_TOUCH:
    // Retrieve touch information
    if (!GetPointerTouchInfo(pointerId, &touchInfo))
    {
        // failure, call GetLastError()
    }
    else
    {
        // success, process touchInfo
        // mark as handled to skip call to DefWindowProc
        fHandled = TRUE;
    }
    break;
case PT_PEN:
    // Retrieve pen information
    if (!GetPointerPenInfo(pointerId, &penInfo))
    {
        // failure, call GetLastError()
    }
    else
    {
        // success, process penInfo
        // mark as handled to skip call to DefWindowProc
        fHandled = TRUE;
    }
    break;
default:
    if (!GetPointerInfo(pointerId, &pointerInfo)) 
    {
        // failure.
    } 
    else 
    {
        // success, proceed with pointerInfo.
        fHandled = HandleGenericPointerInfo(&pointerInfo);
    }
    break;
}

必要条件

要件	価値
サポートされる最小クライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小サーバー	Windows Server 2012 [デスクトップアプリのみ]
ヘッダ	Winuser.h (Windows.h を含む)

次の方法で共有

WM_POINTERUPDATE メッセージ

パラメーター

戻り値

備考

例

必要条件

関連項目

フィードバック

その他のリソース