共用方式為

RegisterTouchWindow 函式 (winuser.h)

  • 發行項

將視窗註冊為可觸控功能。

語法

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

參數

[in] hwnd

要註冊之視窗的控制碼。 如果呼叫執行緒沒有擁有指定的視窗，則函式會失敗 ，並ERROR_ACCESS_DENIED 。

[in] ulFlags

指定選擇性修改的一組位旗標。 此欄位可能包含 0 或下列其中一個值。

值 意義
TWF_FINETOUCH
 指定 hWnd 偏好非coalesced 觸控輸入。
TWF_WANTPALM
 設定此旗標會停用手寫拒絕，以減少取得 WM_TOUCH 訊息的延遲。 如果您想要在使用者觸碰應用程式時盡可能快速回應，這會很有用。

根據預設，會啟用手掌偵測，並防止某些 WM_TOUCH 訊息傳送至您的應用程式。 如果您不想接收來自手掌接觸 WM_TOUCH 訊息，這會很有用。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請使用 GetLastError 函式。

備註

注意在將用於觸控輸入的每個視窗上，都必須呼叫RegisterTouchWindow。 這表示如果您的應用程式內有多個視窗，則必須在該應用程式中使用觸控功能的每個視窗上呼叫 RegisterTouchWindow 。 此外，如果應用程式想要變更修飾詞旗標，則應用程式可以呼叫相同 視窗的任何次數 。 視窗可以使用 UnregisterTouchWindow 函式標示為不再需要觸控輸入。
 
如果啟用 TWF_WANTPALM ，則不會緩衝處理來自觸控輸入的封包，而且不會在封包傳送至您的應用程式之前執行手寫偵測。 如果您想要在處理WM_TOUCH訊息時最少延遲，則啟用TWF_WANTPALM最有用。

範例


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
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll

請參閱

函式

UnregisterTouchWindow