Freigeben über


RegisterTouchWindow-Funktion (winuser.h)

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.

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