Compartilhar via

Função RegisterTouchWindow (winuser.h)

  • Artigo

Registra uma janela como sendo compatível com toque.

Sintaxe

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

Parâmetros

[in] hwnd

O identificador da janela que está sendo registrada. A função falhará com ERROR_ACCESS_DENIED se o thread de chamada não possuir a janela especificada.

[in] ulFlags

Um conjunto de sinalizadores de bits que especificam modificações opcionais. Esse campo pode conter 0 ou um dos valores a seguir.

Valor Significado
TWF_FINETOUCH
 Especifica que hWnd prefere entrada de toque não codificada.
TWF_WANTPALM
 Definir esse sinalizador desabilita a rejeição da palma da mão, o que reduz os atrasos para obter mensagens WM_TOUCH . Isso será útil se você quiser a resposta o mais rápido possível quando um usuário tocar no aplicativo.

Por padrão, a detecção de palma está habilitada e algumas WM_TOUCH mensagens são impedidas de serem enviadas ao seu aplicativo. Isso será útil se você não quiser receber WM_TOUCH mensagens provenientes do contato da palma da mão.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

ObservaçãoRegisterTouchWindow deve ser chamado em todas as janelas que serão usadas para entrada por toque. Isso significa que, se você tiver um aplicativo que tenha várias janelas dentro dele, RegisterTouchWindow deverá ser chamado em cada janela desse aplicativo que usa recursos de toque. Além disso, um aplicativo pode chamar RegisterTouchWindow várias vezes para a mesma janela se quiser alterar os sinalizadores do modificador. Uma janela pode ser marcada como não exigindo mais entrada por toque usando a função UnregisterTouchWindow .
 
Se TWF_WANTPALM estiver habilitada, os pacotes de entrada por toque não serão armazenados em buffer e a detecção de palma não será executada antes que os pacotes sejam enviados ao aplicativo. Habilitar TWF_WANTPALM será mais útil se você quiser latências mínimas ao processar mensagens WM_TOUCH .

Exemplos


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

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Funções

UnregisterTouchWindow