Clase PhysicalGestureRecognizer

[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í.]

Realiza el reconocimiento de gestos en la entrada de puntero alimentada, con la salida devuelta en unidades relativas al dispositivo, en lugar de los píxeles independientes de la pantalla devueltos por GestureRecognizer. Estas unidades de salida son más adecuadas para la entrada del panel táctil para que los gestos se puedan reconocer con respecto al propio panel táctil en lugar de a la pantalla.

Una vez que la entrada del puntero se alimenta al reconocedor, se activa. Permanece activo hasta que se completa la interacción de entrada, ya sea alimentando la entrada de salida para todos los contactos o completando forzosamente a través de CompleteGesture().

Todas las API funcionan de forma idéntica a sus homólogos de GestureRecognizer. La única diferencia es el espacio de coordenadas de la salida reconocida expuesta a través de los eventos de gestos.

Namespace: Windows. Interfaz de usuario. Entrada

Members

Constructor

PhysicalGestureRecognizer();

Devuelve una nueva instancia de physicalGestureRecognizer runtimeclass.

Propiedades

IsActive

Boolean IsActive { get; }

Devuelve si todavía se está procesando una interacción de entrada.

GestureSettings

Windows.UI.Input.GestureSettings GestureSettings;

Obtiene o establece los gestos configurados para el reconocimiento. PhysicalGestureRecognizer admite el siguiente subconjunto de gestos:

  • Pulse
  • Hold
  • ManipulationTranslate[Rails][X,Y]
  • ManipulationRotate
  • ManipulationScale
  • ManipulationMultipleFingerPanning

La entrada del panel táctil nunca se reconocerá como Tap o Hold, ya que la entrada del panel táctil solo se recibe en escenarios en los que esos gestos ya no son posibles para realizar.

TapMinContactCount

UInt32 TapMinContactCount;

Obtiene o establece el número mínimo de contactos necesarios para que se reconozca una pulsación.

TapMaxContactCount

UInt32 TapMaxContactCount;

Obtiene o establece el número máximo de contactos necesarios para que se reconozca una pulsación.

HoldMinContactCount

UInt32 HoldMinContactCount;

Obtiene o establece el número mínimo de contactos necesarios para que se reconozca una suspensión.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Obtiene o establece el número máximo de contactos necesarios para que se reconozca una suspensión.

HoldRadius

Single HoldRadius;

Obtiene o establece el radio dentro del cual un contacto debe permanecer desde su ubicación inferior original para que se reconozca una pulsación o suspensión.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Obtiene o establece la cantidad de tiempo que un contacto debe permanecer inactivo antes de que se reconozca una suspensión. Si la duración del contacto es menor que este valor cuando sale, y no ha viajado más allá de HoldRadius, se reconoce una pulsación.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Obtiene o establece el número mínimo de contactos necesarios para que se reconozca una traducción.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Obtiene o establece el número máximo de contactos necesarios para que se reconozca una traducción.

Methods

ProcessDownEvent, ProcessMoveEvents, ProcessUpEvent

void ProcessDownEvent(Windows.UI.Input.PointerPoint value);
void ProcessMoveEvents(IVector<Windows.UI.Input.PointerPoint> value);
void ProcessUpEvent(Windows.UI.Input.PointerPoint value);

Alimenta la entrada de puntero especificada al elemento PhysicalGestureRecognizer para el reconocimiento de gestos.

CompleteGesture

void CompleteGesture();

Completa la interacción actual para que la entrada posterior se trate como un nuevo gesto. Si un gesto está actualmente en curso, se desencadenarán eventos para su finalización.

Eventos

InicioDeManipulación

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;

Se desencadena cuando PhysicalGestureRecognizer comienza a reconocer una manipulación.

ManipulationUpdated

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;

Se desencadena cuando PhysicalGestureRecognizer recibe la entrada actualizada durante una manipulación.

ManipulaciónCompletada

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;

Se desencadena cuando physicalGestureRecognizer termina de reconocer una manipulación.

Golpeó

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.TappedEventArgs> Tapped;

Se desencadena cuando PhysicalGestureRecognizer reconoce una pulsación.

Tenencia

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.HoldingEventArgs> Holding;

Se desencadena cuando PhysicalGestureRecognizer reconoce un gesto de suspensión.

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 IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d

Consulte también