RegisterTouchWindow-Funktion (winuser.h)

Artikel
08/27/2023

Registriert ein Fenster als touchfähig.

Syntax

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

Parameter

[in] hwnd

Das Handle des fensters, das registriert wird. Die Funktion schlägt mit ERROR_ACCESS_DENIED fehl, wenn der aufrufende Thread nicht der Besitzer des angegebenen Fensters ist.

[in] ulFlags

Eine Reihe von Bitflags, die optionale Änderungen angeben. Dieses Feld kann 0 oder einen der folgenden Werte enthalten.

Wert	Bedeutung
TWF_FINETOUCH	Gibt an, dass hWnd nichtcoalesced Toucheingaben bevorzugt.
TWF_WANTPALM	Durch das Festlegen dieses Flags wird die Palmenabweisung deaktiviert, wodurch die Verzögerungen beim Abrufen von WM_TOUCH Nachrichten reduziert werden. Dies ist nützlich, wenn Sie so schnell wie möglich antworten möchten, wenn ein Benutzer Ihre Anwendung berührt. Standardmäßig ist die Palmerkennung aktiviert, und einige WM_TOUCH Nachrichten werden daran gehindert, an Ihre Anwendung gesendet zu werden. Dies ist nützlich, wenn Sie keine WM_TOUCH Nachrichten empfangen möchten, die von palm contact stammen.

Wert

Bedeutung

TWF_FINETOUCH

Gibt an, dass hWnd nichtcoalesced Toucheingaben bevorzugt.

TWF_WANTPALM

Durch das Festlegen dieses Flags wird die Palmenabweisung deaktiviert, wodurch die Verzögerungen beim Abrufen von WM_TOUCH Nachrichten reduziert werden. Dies ist nützlich, wenn Sie so schnell wie möglich antworten möchten, wenn ein Benutzer Ihre Anwendung berührt.

Standardmäßig ist die Palmerkennung aktiviert, und einige WM_TOUCH Nachrichten werden daran gehindert, an Ihre Anwendung gesendet zu werden. Dies ist nützlich, wenn Sie keine WM_TOUCH Nachrichten empfangen möchten, die von palm contact stammen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.

Hinweise

HinweisRegisterTouchWindow muss in jedem Fenster aufgerufen werden, das für toucheingaben verwendet wird. Wenn Sie also über eine Anwendung verfügen, die mehrere Fenster enthält, muss RegisterTouchWindow für jedes Fenster in der Anwendung aufgerufen werden, das Touchfunktionen verwendet. Außerdem kann eine Anwendung RegisterTouchWindow beliebig oft für dasselbe Fenster aufrufen, wenn sie die Modifiziererflags ändern möchte. Ein Fenster kann mit der UnregisterTouchWindow-Funktion als keine Toucheingabe mehr erforderlich markiert werden.

Wenn TWF_WANTPALM aktiviert ist, werden Pakete von Toucheingaben nicht gepuffert, und die Palmerkennung wird nicht ausgeführt, bevor die Pakete an Ihre Anwendung gesendet werden. Das Aktivieren TWF_WANTPALM ist besonders nützlich, wenn Sie minimale Wartezeiten bei der Verarbeitung WM_TOUCH Nachrichten benötigen.

Beispiele


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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll

Siehe auch

Funktionen

Nicht registrierenTouchWindow

Freigeben über