Fungsi RegisterTouchWindow (winuser.h)

Mendaftarkan jendela sebagai kemampuan sentuhan.

Sintaks

BOOL RegisterTouchWindow(
  [in] HWND  hwnd,
  [in] ULONG ulFlags
);

Parameter

[in] hwnd

Handel jendela sedang didaftarkan. Fungsi gagal dengan ERROR_ACCESS_DENIED jika utas panggilan tidak memiliki jendela yang ditentukan.

[in] ulFlags

Sekumpulan bendera bit yang menentukan modifikasi opsional. Bidang ini mungkin berisi 0 atau salah satu nilai berikut.

Nilai	Makna
TWF_FINETOUCH	Menentukan bahwa hWnd lebih memilih input sentuhan nonkoaleskulasi.
TWF_WANTPALM	Mengatur bendera ini menonaktifkan penolakan telapak tangan yang mengurangi penundaan untuk mendapatkan pesan WM_TOUCH . Ini berguna jika Anda ingin secepat mungkin respons ketika pengguna menyentuh aplikasi Anda. Secara default, deteksi telapak tangan diaktifkan dan beberapa pesan WM_TOUCH dicegah dikirim ke aplikasi Anda. Ini berguna jika Anda tidak ingin menerima pesan WM_TOUCH yang berasal dari kontak palm.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, gunakan fungsi GetLastError .

Keterangan

CatatanRegisterTouchWindow harus dipanggil pada setiap jendela yang akan digunakan untuk input sentuhan. Ini berarti bahwa jika Anda memiliki aplikasi yang memiliki beberapa jendela di dalamnya, RegisterTouchWindow harus dipanggil pada setiap jendela dalam aplikasi yang menggunakan fitur sentuh. Selain itu, aplikasi dapat memanggil RegisterTouchWindow beberapa kali untuk jendela yang sama jika ingin mengubah bendera pengubah. Jendela dapat ditandai sebagai tidak lagi memerlukan input sentuhan menggunakan fungsi UnregisterTouchWindow .

 

Jika TWF_WANTPALM diaktifkan, paket dari input sentuh tidak di-buffer dan deteksi telapak tangan tidak dilakukan sebelum paket dikirim ke aplikasi Anda. Mengaktifkan TWF_WANTPALM paling berguna jika Anda menginginkan latensi minimal saat memproses pesan WM_TOUCH .

Contoh

BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
   HWND hWnd;

   hInst = hInstance; // Store instance handle in the global variable.

   hWnd = CreateWindow(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
      CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, hInstance, NULL);

   RegisterTouchWindow(hWnd, 0);

   if (!hWnd)
   {
      return FALSE;
   }

   ShowWindow(hWnd, nCmdShow);
   UpdateWindow(hWnd);

   return TRUE;
}	 
	 

Persyaratan

Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Fungsi

UnregisterTouchWindow