RAWMOUSE

マウスの状態に関する情報を格納します。

MOUSE_MOVE_RELATIVE または MOUSE_MOVE_ABSOLUTE によってマウスが移動したことが示されている場合、lLastX と lLastY はその移動に関する情報を指定します。この情報は、相対または絶対の整数値として指定されます。

MOUSE_MOVE_RELATIVE が指定されている場合、lLastX と lLastY は直前のマウスイベント(最後に報告された位置)からの相対的な移動量を指定します。正の値はマウスが右(または下)へ移動したことを意味し、負の値はマウスが左(または上)へ移動したことを意味します。

MOUSE_MOVE_ABSOLUTE が指定されている場合、lLastX と lLastY には 0 ～ 65,535 の範囲に正規化された絶対座標が格納されます。座標 (0,0) は表示面の左上隅に対応し、座標 (65535,65535) は右下隅に対応します。マルチモニターシステムでは、座標はプライマリモニターにマップされます。

MOUSE_MOVE_ABSOLUTE に加えて MOUSE_VIRTUAL_DESKTOP が指定されている場合、座標は仮想デスクトップ全体にマップされます。

case WM_INPUT:
{
    UINT dwSize = sizeof(RAWINPUT);
    static BYTE lpb[sizeof(RAWINPUT)];

    GetRawInputData((HRAWINPUT)lParam, RID_INPUT, lpb, &dwSize, sizeof(RAWINPUTHEADER));

    RAWINPUT* raw = (RAWINPUT*)lpb;

    if (raw->header.dwType == RIM_TYPEMOUSE)
    {
        RAWMOUSE& mouse = raw->data.mouse;

        if (mouse.usFlags & MOUSE_MOVE_ABSOLUTE)
        {
            RECT rect;
            if (mouse.usFlags & MOUSE_VIRTUAL_DESKTOP)
            {
                rect.left = GetSystemMetrics(SM_XVIRTUALSCREEN);
                rect.top = GetSystemMetrics(SM_YVIRTUALSCREEN);
                rect.right = GetSystemMetrics(SM_CXVIRTUALSCREEN);
                rect.bottom = GetSystemMetrics(SM_CYVIRTUALSCREEN);
            }
            else
            {
                rect.left = 0;
                rect.top = 0;
                rect.right = GetSystemMetrics(SM_CXSCREEN);
                rect.bottom = GetSystemMetrics(SM_CYSCREEN);
            }

            int absoluteX = MulDiv(mouse.lLastX, rect.right, USHRT_MAX) + rect.left;
            int absoluteY = MulDiv(mouse.lLastY, rect.bottom, USHRT_MAX) + rect.top;
            ...
        }
        else if (mouse.lLastX != 0 || mouse.lLastY != 0)
        {
            int relativeX = mouse.lLastX;
            int relativeY = mouse.lLastY;
            ...
        }
        ...
    }

    return 0;
}

従来の WM_MOUSEMOVE ウィンドウメッセージとは異なり、Raw Input のマウスイベントは、コントロールパネルのマウスのプロパティシートで設定されたマウス速度の影響を受けません。詳細については、マウス入力の概要を参照してください。

usButtonFlags の RI_MOUSE_WHEEL または RI_MOUSE_HWHEEL によってマウスホイールが回転したことが示されている場合、usButtonData にはホイールの回転量を指定する符号付き short 値が格納されます。

ホイールの回転量は、120 に設定されている WHEEL_DELTA の倍数になります。これはアクションを実行するためのしきい値であり、デルタごとに 1 回のアクション(たとえば 1 単位分のスクロール)を行うべきです。

デルタが 120 に設定されているのは、Microsoft や他のベンダーが、より高分解能のホイール(ノッチのない自由回転式ホイール)を作成し、1 回転あたりより多くのメッセージを、各メッセージにはより小さい値を入れて送信できるようにするためです。この機能を使用するには、受信したデルタ値を WHEEL_DELTA に達するまで加算する(これにより 1 デルタ分の回転に対して同じ応答が得られます)か、より頻繁なメッセージに応じて行の一部をスクロールします。また、独自のスクロール粒度を選択し、それに達するまでデルタを蓄積することもできます。

アプリケーションは、SystemParametersInfo API に SPI_GETWHEELSCROLLLINES または SPI_GETWHEELSCROLLCHARS パラメーターを指定して、現在のユーザー設定のスクロール行数やスクロール文字数を取得することもできます。

このようなホイール処理コードの例を次に示します。

RAWMOUSE& mouse = raw->data.mouse;

if ((mouse.usButtonFlags & RI_MOUSE_WHEEL) || (mouse.usButtonFlags & RI_MOUSE_HWHEEL))
{
    short wheelDelta = (short)mouse.usButtonData;
    float scrollDelta = (float)wheelDelta / WHEEL_DELTA;

    if (mouse.usButtonFlags & RI_MOUSE_HWHEEL) // Horizontal
    {
        unsigned long scrollChars = 1; // 1 is the default
        SystemParametersInfo(SPI_GETWHEELSCROLLCHARS, 0, &scrollChars, 0);
        scrollDelta *= scrollChars;
        ...
    }
    else // Vertical
    {
        unsigned long scrollLines = 3; // 3 is the default
        SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, &scrollLines, 0);
        if (scrollLines != WHEEL_PAGESCROLL)
            scrollDelta *= scrollLines;
        ...
    }
}