Classe PhysicalGestureRecognizer

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.]

Effectue la reconnaissance des mouvements sur l’entrée du pointeur qui lui est transmise, avec la sortie retournée en unités par rapport à l’appareil, plutôt que les pixels indépendants de l’affichage retournés par GestureRecognizer. Ces unités de sortie sont mieux adaptées à l’entrée du pavé tactile afin que les mouvements puissent être reconnus par rapport au pavé tactile lui-même plutôt qu’à l’affichage.

Une fois que l’entrée du pointeur est transmise au module de reconnaissance, elle devient active. Elle reste active jusqu’à ce que l’interaction d’entrée soit terminée , soit en alimentant l’entrée sortante pour tous les contacts, soit en la terminant de force via CompleteGesture().

Toutes les API fonctionnent de façon identique à leurs équivalents dans GestureRecognizer. La seule différence est l’espace de coordonnées de la sortie reconnue exposée via les événements de mouvement.

Namespace : Windows. UI. Entrée

Members

Constructor

PhysicalGestureRecognizer();

Retourne une nouvelle instance de la classe runtime PhysicalGestureRecognizer .

Propriétés

IsActive

Boolean IsActive { get; }

Retourne si une interaction d’entrée est toujours en cours de traitement.

GestureSettings

Windows.UI.Input.GestureSettings GestureSettings;

Obtient ou définit les mouvements configurés pour la reconnaissance. PhysicalGestureRecognizer prend en charge le sous-ensemble de mouvements suivant :

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

L’entrée du pavé tactile ne sera jamais reconnue comme tap ou hold, car l’entrée du pavé tactile n’est reçue que dans les scénarios où ces mouvements ne sont plus possibles.

TapMinContactCount

UInt32 TapMinContactCount;

Obtient ou définit le nombre minimal de contacts requis pour qu’un appui soit reconnu.

TapMaxContactCount

UInt32 TapMaxContactCount;

Obtient ou définit le nombre maximal de contacts requis pour qu’un appui soit reconnu.

HoldMinContactCount

UInt32 HoldMinContactCount;

Obtient ou définit le nombre minimal de contacts requis pour qu’une conservation soit reconnue.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Obtient ou définit le nombre maximal de contacts requis pour qu’une conservation soit reconnue.

HoldRadius

Single HoldRadius;

Obtient ou définit le rayon dans lequel un contact doit rester à partir de son emplacement inférieur d’origine pour qu’un appui ou une conservation soit reconnu.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Obtient ou définit la durée pendant laquelle un contact doit rester arrêté avant qu’une conservation soit reconnue. Si la durée du contact est inférieure à cette valeur lorsqu’il part, et qu’il n’a pas voyagé plus loin que le HoldRadius, un appui est reconnu.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Obtient ou définit le nombre minimal de contacts requis pour qu’une traduction soit reconnue.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Obtient ou définit le nombre maximal de contacts requis pour qu’une traduction soit reconnue.

Méthodes

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

Alimente l’entrée de pointeur spécifiée vers PhysicalGestureRecognizer pour la reconnaissance des mouvements.

CompleteGesture

void CompleteGesture();

Termine l’interaction actuelle afin que l’entrée suivante soit traitée comme un nouveau mouvement. Si un mouvement est en cours, les événements de sa fin sont déclenchés.

Événements

ManipulationStarted

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

Déclenché lorsque physicalGestureRecognizer commence à reconnaître une manipulation.

ManipulationUpdated

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

Déclenché lorsque PhysicalGestureRecognizer reçoit une entrée mise à jour pendant une manipulation.

ManipulationCompleted

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

Déclenché lorsque physicalGestureRecognizer termine la reconnaissance d’une manipulation.

Appuyé

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

Déclenché lorsque PhysicalGestureRecognizer reconnaît un appui.

Holding

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

Déclenché lorsque PhysicalGestureRecognizer reconnaît un mouvement de conservation.

Exigences

Prérequis Valeur
Client minimum requis Windows 11
Namespace Windows. UI. Entrée
Contrat API Windows. Foundation.UniversalApiContract (version 19)
IID IPhysicalGestureRecognizer : 79a29f4d-32a6-5aa5-a999-42b0b420c66d

Voir également

  • Last updated on