RegisterTouchWindow, fonction (winuser.h)

Article
08/27/2023

Inscrit une fenêtre comme étant tactile.

Syntaxe

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

Paramètres

[in] hwnd

Handle de la fenêtre en cours d’inscription. La fonction échoue avec ERROR_ACCESS_DENIED si le thread appelant ne possède pas la fenêtre spécifiée.

[in] ulFlags

Ensemble d’indicateurs de bits qui spécifient des modifications facultatives. Ce champ peut contenir 0 ou l’une des valeurs suivantes.

Valeur	Signification
TWF_FINETOUCH	Spécifie que hWnd préfère l’entrée tactile non coalesced.
TWF_WANTPALM	La définition de cet indicateur désactive le rejet de la paume, ce qui réduit les délais d’obtention des messages WM_TOUCH . Cela est utile si vous souhaitez obtenir une réponse aussi rapide que possible lorsqu’un utilisateur touche votre application. Par défaut, la détection de la paume de main est activée et certains messages WM_TOUCH ne peuvent pas être envoyés à votre application. Cela est utile si vous ne souhaitez pas recevoir de messages WM_TOUCH provenant d’un contact palm.

Valeur

Signification

TWF_FINETOUCH

Spécifie que hWnd préfère l’entrée tactile non coalesced.

TWF_WANTPALM

La définition de cet indicateur désactive le rejet de la paume, ce qui réduit les délais d’obtention des messages WM_TOUCH . Cela est utile si vous souhaitez obtenir une réponse aussi rapide que possible lorsqu’un utilisateur touche votre application.

Par défaut, la détection de la paume de main est activée et certains messages WM_TOUCH ne peuvent pas être envoyés à votre application. Cela est utile si vous ne souhaitez pas recevoir de messages WM_TOUCH provenant d’un contact palm.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .

Remarques

RemarqueRegisterTouchWindow doit être appelé sur chaque fenêtre qui sera utilisée pour l’entrée tactile. Cela signifie que si vous avez une application qui comporte plusieurs fenêtres, RegisterTouchWindow doit être appelé sur chaque fenêtre de cette application qui utilise des fonctionnalités tactiles. En outre, une application peut appeler RegisterTouchWindow n’importe quel nombre de fois pour la même fenêtre si elle souhaite modifier les indicateurs de modification. Une fenêtre peut être marquée comme ne nécessitant plus d’entrée tactile à l’aide de la fonction UnregisterTouchWindow .

Si TWF_WANTPALM est activé, les paquets provenant de l’entrée tactile ne sont pas mis en mémoire tampon et la détection de la paume n’est pas effectuée avant l’envoi des paquets à votre application. L’activation de TWF_WANTPALM est particulièrement utile si vous souhaitez des latences minimales lors du traitement des messages WM_TOUCH.

Exemples


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

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll

Voir aussi

Fonctions

UnregisterTouchWindow

Partager via