Compartir a través de

Función RegisterTouchWindow (winuser.h)

Registra una ventana como compatible con la función táctil.

Sintaxis

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

Parámetros

[in] hwnd

Identificador de la ventana que se está registrando. Se produce un error en la función ERROR_ACCESS_DENIED si el subproceso que realiza la llamada no posee la ventana especificada.

[in] ulFlags

Un conjunto de marcas de bits que especifican modificaciones opcionales. Este campo puede contener 0 o uno de los valores siguientes.

Valor Significado
TWF_FINETOUCH
 Especifica que hWnd prefiere la entrada táctil no codificada.
TWF_WANTPALM
 Al establecer esta marca, se deshabilita el rechazo de la palma, lo que reduce los retrasos para obtener mensajes WM_TOUCH . Esto resulta útil si desea una respuesta lo más rápida posible cuando un usuario toca la aplicación.

De forma predeterminada, la detección de palma está habilitada y se impide que se envíen algunos mensajes de WM_TOUCH a la aplicación. Esto es útil si no desea recibir WM_TOUCH mensajes procedentes del contacto de palma.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use la función GetLastError .

Comentarios

Nota Se debe llamar a RegisterTouchWindow en todas las ventanas que se usarán para la entrada táctil. Esto significa que, si tiene una aplicación que tiene varias ventanas dentro de ella, se debe llamar a RegisterTouchWindow en todas las ventanas de esa aplicación que usen características táctiles. Además, una aplicación puede llamar a RegisterTouchWindow cualquier número de veces para la misma ventana si desea cambiar las marcas modificadoras. Una ventana se puede marcar como ya no requiere entrada táctil mediante la función UnregisterTouchWindow .
 
Si TWF_WANTPALM está habilitado, los paquetes de entrada táctil no se almacenan en búfer y la detección de palma no se realiza antes de que los paquetes se envíen a la aplicación. Habilitar TWF_WANTPALM es más útil si desea latencias mínimas al procesar WM_TOUCH mensajes.

Ejemplos


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 compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll

Vea también

Funciones

Anular el registroTouchWindow

  • Last updated on