WM_TOUCH pesan

Memberi tahu jendela saat satu atau beberapa titik sentuhan, seperti jari atau pena, menyentuh permukaan digitizer sensitif sentuhan.

Parameter

wParam

Kata berurutan rendah berisi jumlah titik sentuh yang terkait dengan pesan ini. Kata berurutan tinggi dicadangkan untuk digunakan di masa mendatang.

lParam

Berisi handel input sentuh yang dapat digunakan dalam panggilan ke GetTouchInputInfo untuk mengambil informasi terperinci tentang titik sentuh yang terkait dengan pesan ini.

Handel ini hanya valid dalam proses saat ini dan tidak boleh diteruskan lintas proses kecuali sebagai LPARAM dalam panggilan SendMessage atau PostMessage .

Ketika aplikasi tidak lagi memerlukan handel ini, aplikasi harus memanggil CloseTouchInputHandle untuk membebaskan memori proses yang terkait dengan handel ini. Gagal melakukannya dapat mengakibatkan kebocoran memori aplikasi.

Perhatikan bahwa handel input sentuh dalam parameter ini tidak lagi valid setelah pesan diteruskan ke DefWindowProc. DefWindowProc akan menutup dan membatalkan handel ini.

Perhatikan juga bahwa handel input sentuh dalam parameter ini tidak lagi valid setelah pesan diteruskan menggunakan PostMessage, SendMessage, atau salah satu variannya. Fungsi-fungsi ini akan menutup dan membatalkan handel ini.

Mengembalikan nilai

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.

Jika aplikasi tidak memproses pesan, aplikasi harus memanggil DefWindowProc. Tidak melakukannya menyebabkan aplikasi bocor memori karena handel input sentuh tidak ditutup dan memori proses terkait tidak dibebaskan.

Keterangan

WM_TOUCH pesan tidak menghormati wilayah HTTRANSPARENT jendela. Jika jendela mengembalikan HTTRANSPARENT sebagai respons terhadap pesan WM_NCHITTEST , pesan mouse masuk ke induk, dan WM_TOUCH pesan langsung masuk ke jendela.

Contoh

Kode berikut adalah contoh cara mendapatkan informasi input sentuhan terperinci yang terkait dengan pesan ini.

UINT cInputs = LOWORD(wParam);
PTOUCHINPUT pInputs = new TOUCHINPUT[cInputs];
if (NULL != pInputs)
{
    if (GetTouchInputInfo((HTOUCHINPUT)lParam,
                          cInputs,
                          pInputs,
                          sizeof(TOUCHINPUT)))
    {
        // process pInputs
        if (!CloseTouchInputHandle((HTOUCHINPUT)lParam))
        {
            // error handling
        }
    }
    else
    {
        // GetLastError() and error handling
    }
    delete [] pInputs;
}
else
{
    // error handling, presumably out of memory
}
return DefWindowProc(hWnd, message, wParam, lParam);

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

Pesan

Panduan Pemrograman Manipulasi dan Inertia

Panduan Pemrograman Input Sentuh Windows