Функция RegisterTouchWindow (winuser.h)

Регистрирует окно с поддержкой сенсорного ввода.

Синтаксис

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

Параметры

[in] hwnd

Дескриптор регистрируемого окна. Функция завершается сбоем с ERROR_ACCESS_DENIED , если вызывающий поток не владеет указанным окном.

[in] ulFlags

Набор битовых флагов, указывающих необязательные изменения. Это поле может содержать 0 или одно из следующих значений.

Значение	Значение
TWF_FINETOUCH	Указывает, что hWnd предпочитает необязательный сенсорный ввод.
TWF_WANTPALM	Установка этого флага отключает отклонение ладони, что сокращает задержки при получении WM_TOUCH сообщений. Это полезно, если требуется как можно быстрее получать ответ, когда пользователь обращается к вашему приложению. По умолчанию обнаружение ладоней включено, и некоторые WM_TOUCH сообщения не отправляются в приложение. Это полезно, если вы не хотите получать WM_TOUCH сообщения от контакта ладони.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Комментарии

Примечание. RegisterTouchWindow необходимо вызывать в каждом окне, которое будет использоваться для сенсорного ввода. Это означает, что если у вас есть приложение с несколькими окнами, необходимо вызывать RegisterTouchWindow в каждом окне этого приложения, использующего сенсорные функции. Кроме того, приложение может вызывать RegisterTouchWindow любое количество раз для одного и того же окна, если требуется изменить флаги модификатора. Окно можно пометить как не требующее сенсорного ввода с помощью функции UnregisterTouchWindow .

 

Если включена TWF_WANTPALM , пакеты от сенсорного ввода не буферизаются и обнаружение ладоней не выполняется до отправки пакетов в приложение. Включение TWF_WANTPALM наиболее полезно, если требуется минимальная задержка при обработке WM_TOUCH сообщений.

Примеры

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

Требования

Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll

См. также

Функции

Отменить регистрациюTouchWindow