Funzione RegisterTouchWindow (winuser.h)

Articolo
08/27/2023

Registra una finestra come compatibile con tocco.

Sintassi

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

Parametri

[in] hwnd

Handle della finestra registrata. La funzione ha esito negativo con ERROR_ACCESS_DENIED se il thread chiamante non possiede la finestra specificata.

[in] ulFlags

Set di flag di bit che specificano modifiche facoltative. Questo campo può contenere 0 o uno dei valori seguenti.

Valore	Significato
TWF_FINETOUCH	Specifica che hWnd preferisce l'input tocco noncoalesced.
TWF_WANTPALM	L'impostazione di questo flag disabilita il rifiuto del palmo che riduce i ritardi per ottenere WM_TOUCH messaggi. Ciò è utile se si vuole una risposta più rapida possibile quando un utente tocca l'applicazione. Per impostazione predefinita, il rilevamento palmo è abilitato e alcuni messaggi WM_TOUCH non vengono inviati all'applicazione. Questo è utile se non si desidera ricevere WM_TOUCH messaggi provenienti dal contatto palmo.

Valore

Significato

TWF_FINETOUCH

Specifica che hWnd preferisce l'input tocco noncoalesced.

TWF_WANTPALM

L'impostazione di questo flag disabilita il rifiuto del palmo che riduce i ritardi per ottenere WM_TOUCH messaggi. Ciò è utile se si vuole una risposta più rapida possibile quando un utente tocca l'applicazione.

Per impostazione predefinita, il rilevamento palmo è abilitato e alcuni messaggi WM_TOUCH non vengono inviati all'applicazione. Questo è utile se non si desidera ricevere WM_TOUCH messaggi provenienti dal contatto palmo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, usare la funzione GetLastError .

Commenti

NotaRegisterTouchWindow deve essere chiamato in ogni finestra che verrà usata per l'input tocco. Ciò significa che se si dispone di un'applicazione con più finestre all'interno di esso, RegisterTouchWindow deve essere chiamato in ogni finestra di tale applicazione che usa le funzionalità di tocco. Inoltre, un'applicazione può chiamare RegisterTouchWindow qualsiasi numero di volte per la stessa finestra se desidera modificare i flag di modifica. Una finestra può essere contrassegnata come non richiede più input tocco usando la funzione UnregisterTouchWindow .

Se TWF_WANTPALM è abilitato, i pacchetti dall'input tocco non vengono memorizzati nel buffer e il rilevamento palmo non viene eseguito prima che i pacchetti vengano inviati all'applicazione. L'abilitazione di TWF_WANTPALM è più utile se si desiderano latenze minime durante l'elaborazione di messaggi di WM_TOUCH .

Esempio


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

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Vedi anche

Funzioni

Annullare la registrazione diTouchWindow

Condividi tramite