Clase TouchpadGesturesController

[Cierta información se relaciona con el producto publicado previamente que puede modificarse sustancialmente antes de su publicación comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.]

Permite que una aplicación se registre para los gestos globales del panel táctil que implican tres o más contactos, proporcionando su propio controlador en lugar del comportamiento predeterminado del sistema.

Las pulsaciones y los deslizamientos que implican tres o más contactos se consideran gestos globales. El sistema comprobará primero los controladores registrados por el proceso en primer plano cuando se realice un gesto global del panel táctil. Si no se encuentra ninguno que esté habilitado y admita el gesto, el gesto se enrutará al propio controlador del sistema. Los controladores en procesos en segundo plano se omiten.

Namespace: Windows. Interfaz de usuario. Entrada

Members

Métodos estáticos

EstáSoportado

static Boolean IsSupported();

Devuelve si se admite la funcionalidad de TouchpadGesturesController en el sistema.

CreateForProcess

static TouchpadGesturesController CreateForProcess();

Crea un TouchpadGesturesController para el proceso asociado. Se pueden crear varios controladores para un proceso determinado, pero si se habilitan varios controladores y declaran compatibilidad con el mismo gesto, solo uno recibirá los eventos asociados.

El controlador crea una ventana en el subproceso en el que se crea y, por lo tanto, requiere que el subproceso tenga una bomba de mensajes. Todos los eventos del controlador se generarán en este subproceso, aunque se pueden configurar desde cualquier subproceso. La ventana del controlador se marca como compatible con el panel táctil a través de RegisterTouchpadCapableWindow ; vea su documentación sobre cómo se ve afectado el subproceso.

Propiedades

Habilitado

Boolean Enabled;

Obtiene o establece si el controlador está habilitado. Si está deshabilitado, el sistema no lo considerará como un destino válido para los gestos de enrutamiento.

SupportedGestures

TouchpadGlobalGestureKinds SupportedGestures;

Obtiene o establece los gestos admitidos por el controlador. El sistema solo enrutará los gestos al controlador si ha declarado la compatibilidad con ellos. Las manipulaciones hacen referencia a la entrada del panel táctil en la que los dedos se han movido (por ejemplo, deslizando el dedo a través del panel táctil), mientras que las acciones se producen por dedos fijos (por ejemplo, pulsar o presionar el botón de superficie del panel táctil sin mover).

Eventos

PointerPressed, PointerMoved, PointerReleased

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    Windows.UI.Core.PointerEventArgs> PointerPressed;

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    Windows.UI.Core.PointerEventArgs> PointerMoved;

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    Windows.UI.Core.PointerEventArgs> PointerReleased;

Estos eventos se desencadenan para los gestos de estilo de "manipulación". Funcionan de forma idéntica a la forma en que la entrada del puntero normalmente fluye a una aplicación: cada dedo desencadenará PointerPressed, seguido de cero o más PointerMoved, finalizado por PointerReleased.

Nota:

La entrada de puntero para los teclados táctiles tiene algunas diferencias en comparación con otros tipos de dispositivos de puntero. Vea los comentarios de GetPointerTouchpadInfo para obtener más información.

Nota:

Aunque se permite usar las API de Win32, como GetPointerInfo , para consultar información sobre la entrada de puntero mientras se controla uno de estos eventos, no se debe llamar a SkipPointerFrameMessages . TouchpadGesturesController realiza el procesamiento en la entrada además de desencadenar el evento y omitir los mensajes de puntero podría hacer que su procesamiento se comporte incorrectamente.

GlobalActionPerformed

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    TouchpadGlobalActionEventArgs> GlobalActionPerformed;

Se desencadena para los gestos de estilo de "acción".

  • [X]FingerTap: desencadenado por el usuario que realiza una pulsación con varios dedos en el panel táctil.
  • [X]FingerPress: desencadenado por el usuario presionando hacia abajo en el botón de superficie del panel táctil con varios dedos.
  • [X]FingerRelease: desencadenado por el usuario que suelta el botón de superficie del panel táctil después del evento anterior.

TouchpadGlobalGestureKinds

[flags]
enum TouchpadGlobalGestureKinds
{
    None                        = 0x0,
    ThreeFingerManipulations    = 0x1,
    FourFingerManipulations     = 0x2,
    FiveFingerManipulations     = 0x4,
    ThreeFingerActions          = 0x8,
    FourFingerActions           = 0x10,
    FiveFingerActions           = 0x20,
};
Importancia Meaning
Ninguno (0x0) Sin gestos.
ThreeFingerManipulations (0x1) Gestos de deslizar o arrastrar de tres dedos.
FourFingerManipulations (0x2) Gestos de deslizar o arrastrar de cuatro dedos.
FiveFingerManipulations (0x4) Gestos de deslizar o arrastrar con cinco dedos.
ThreeFingerActions (0x8) Pulsación de tres dedos y gestos de pulsación de botón.
FourFingerActions (0x10) Pulsación de cuatro dedos y gestos de pulsación de botón.
FiveFingerActions (0x20) Pulsación de cinco dedos y pulsación de botón.

TouchpadGlobalAction

enum TouchpadGlobalAction
{
    ThreeFingerTap,
    FourFingerTap,
    FiveFingerTap,
    ThreeFingerPress,
    FourFingerPress,
    FiveFingerPress,
    ThreeFingerRelease,
    FourFingerRelease,
    FiveFingerRelease,
};
Importancia Meaning
ThreeFingerTap Toque de tres dedos en el panel táctil.
FourFingerTap Toque de cuatro dedos en el panel táctil.
FiveFingerTap Toque de cinco dedos en el panel táctil.
ThreeFingerPress Pulsa tres dedos en el botón de superficie del panel táctil.
FourFingerPress Presione cuatro dedos en el botón de superficie del panel táctil.
FiveFingerPress Presione cinco dedos en el botón de superficie del panel táctil.
ThreeFingerRelease Suelta después de una pulsación de tres dedos.
FourFingerRelease Suelta después de una pulsación de cuatro dedos.
FiveFingerRelease Suelte después de presionar un botón de cinco dedos.

Requisitos

Requisito Importancia
Cliente mínimo compatible Windows 11
Namespace Windows. Interfaz de usuario. Entrada
Contrato de API Windows. Foundation.UniversalApiContract (versión 19)
IID ITouchpadGesturesController: 28c13cdd-e068-549f-89c6-1a440c6fc327, ITouchpadGesturesControllerStatics: 207ef171-1a73-51cd-a694-8840e09dbafa, ITouchpadGlobalActionEventArgs: 6edad206-e4e3-5f39-9d13-8575e8e2a12b

Consulte también

  • Last updated on