Struktur RAWMOUSE (winuser.h)

Berisi informasi tentang status tetikus.

Sintaksis

typedef struct tagRAWMOUSE {
  USHORT usFlags;
  union {
    ULONG ulButtons;
    struct {
      USHORT usButtonFlags;
      USHORT usButtonData;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  ULONG  ulRawButtons;
  LONG   lLastX;
  LONG   lLastY;
  ULONG  ulExtraInformation;
} RAWMOUSE, *PRAWMOUSE, *LPRAWMOUSE;

Anggota

usFlags

Jenis: USHORT

Status mouse. Anggota ini bisa menjadi kombinasi yang wajar dari berikut ini.

DUMMYUNIONNAME

DUMMYUNIONNAME.ulButtons

Jenis: ULONG

Dipesan.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.usButtonFlags

Jenis: USHORT

Status transisi tombol mouse. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.usButtonData

Jenis: USHORT

Jika usButtonFlags memiliki RI_MOUSE_WHEEL atau RI_MOUSE_HWHEEL, anggota ini menentukan jarak roda diputar. Untuk informasi selengkapnya, lihat bagian Keterangan berikut.

ulRawButtons

Jenis: ULONG

Status mentah tombol mouse. Subsistem Win32 tidak menggunakan anggota ini.

lLastX

Jenis: LONG

Gerakan ke arah X. Ini ditandatangani gerakan relatif atau gerakan absolut, tergantung pada nilai usFlags.

lLastY

Jenis: LONG

Gerakan ke arah Y. Ini ditandatangani gerakan relatif atau gerakan absolut, tergantung pada nilai usFlags.

ulExtraInformation

Jenis: ULONG

Informasi khusus perangkat tambahan untuk peristiwa tersebut. Lihat Membedakan Input Pena dari Mouse dan Sentuh untuk informasi selengkapnya.

Komentar

Jika mouse telah bergerak, ditunjukkan oleh MOUSE_MOVE_RELATIVE atau MOUSE_MOVE_ABSOLUTE, lLastX dan lLastY menentukan informasi tentang gerakan tersebut. Informasi ditentukan sebagai nilai bilangan bulat relatif atau absolut.

Jika nilai MOUSE_MOVE_RELATIVE ditentukan, lLastX dan lLastY menentukan gerakan relatif terhadap peristiwa mouse sebelumnya (posisi terakhir yang dilaporkan). Nilai positif berarti mouse bergerak ke kanan (atau ke bawah); nilai negatif berarti mouse bergerak ke kiri (atau ke atas).

Jika nilai MOUSE_MOVE_ABSOLUTE ditentukan, lLastX dan lLastY berisi koordinat absolut yang dinormalisasi antara 0 dan 65.535. Koordinat (0,0) peta ke sudut kiri atas permukaan tampilan; koordinat (65535.65535) memetakan ke sudut kanan bawah. Dalam sistem multimonitor, koordinat memetakan ke monitor utama.

Jika MOUSE_VIRTUAL_DESKTOP ditentukan selain MOUSE_MOVE_ABSOLUTE, koordinat memetakan ke seluruh desktop virtual.

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;
}

Berbeda dengan pesan jendela warisan WM_MOUSEMOVE peristiwa mouse Input Mentah tidak tunduk pada efek kecepatan mouse yang diatur dalam lembar Properti Mouse Panel Kontrol. Lihat Gambaran Umum Input Mouse untuk detailnya.

Jika roda mouse dipindahkan, ditunjukkan oleh RI_MOUSE_WHEEL atau RI_MOUSE_HWHEEL di usButtonFlags, maka usButtonData berisi nilai pendek yang menentukan jarak roda diputar.

Rotasi roda akan menjadi kelipatan WHEEL_DELTA, yang diatur pada 120. Ini adalah ambang batas untuk tindakan yang akan diambil, dan satu tindakan seperti itu (misalnya, menggulir satu kenaikan) harus terjadi untuk setiap delta.

Delta diatur ke 120 untuk memungkinkan Microsoft atau vendor lain membangun roda resolusi yang lebih halus (roda yang diputar bebas tanpa takik) untuk mengirim lebih banyak pesan per rotasi, tetapi dengan nilai yang lebih kecil di setiap pesan. Untuk menggunakan fitur ini, Anda dapat menambahkan nilai delta masuk hingga WHEEL_DELTA tercapai (sehingga untuk rotasi delta Anda mendapatkan respons yang sama), atau menggulir baris parsial sebagai respons terhadap pesan yang lebih sering. Anda juga dapat memilih granularitas gulir dan mengakumulasi delta hingga tercapai.

Aplikasi ini juga dapat mengambil pengaturan pengguna lines-to-scroll dan characters-to-scroll saat ini dengan menggunakan SystemParametersInfo API dengan parameter SPI_GETWHEELSCROLLLINES atau SPI_GETWHEELSCROLLCHARS.

Berikut adalah contoh kode penanganan roda tersebut:

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;
        ...
    }
}

Persyaratan

Lihat juga

Konseptual

GetRawInputDeviceInfo

RAWINPUT

Input Mentah

Referensi

struktur MOUSEINPUT

fungsi SendInput

struktur MOUSE_INPUT_DATA

Gambaran Umum Input Mouse (warisan)

Pemberitahuan Input Mouse (warisan)

SystemParametersInfo