TouchpadGesturesController, classe

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

Permet à une application de s’inscrire aux mouvements de pavé tactile globaux impliquant trois contacts ou plus, en fournissant leur propre gestionnaire au lieu du comportement système par défaut.

Les appuis et balayages impliquant trois contacts ou plus sont considérés comme des mouvements globaux. Le système vérifie d’abord les contrôleurs inscrits par le processus de premier plan lorsqu’un mouvement global du pavé tactile est effectué. Si aucun élément n’est activé et qu’il prend en charge le mouvement, le mouvement est acheminé vers le propre gestionnaire du système. Les contrôleurs dans les processus en arrière-plan sont ignorés.

Namespace : Windows. UI. Entrée

Members

Méthodes statiques

IsSupported

static Boolean IsSupported();

Retourne si la fonctionnalité touchpadGesturesController est prise en charge sur le système.

CreateForProcess

static TouchpadGesturesController CreateForProcess();

Crée un TouchpadGesturesController pour le processus associé. Plusieurs contrôleurs peuvent être créés pour un processus donné, mais si plusieurs contrôleurs sont activés et déclarent la prise en charge du même mouvement, un seul reçoit les événements associés.

Le contrôleur crée une fenêtre sur le thread sur lequel il est créé et nécessite donc que le thread dispose d’une pompe de message. Les événements du contrôleur sont tous déclenchés sur ce thread, bien qu’ils puissent être configurés à partir de n’importe quel thread. La fenêtre du contrôleur est marquée comme prenant en charge le pavé tactile via RegisterTouchpadCapableWindow . Consultez sa documentation sur l’impact du thread.

Propriétés

Activé

Boolean Enabled;

Obtient ou définit si le contrôleur est activé. S’il est désactivé, il ne sera pas considéré par le système comme une cible valide pour les mouvements de routage.

Prise en charge desgestures

TouchpadGlobalGestureKinds SupportedGestures;

Obtient ou définit les mouvements pris en charge par le contrôleur. Le système achemine uniquement les mouvements vers le contrôleur s’il a déclaré la prise en charge pour eux. Les manipulations font référence à l’entrée du pavé tactile où les doigts ont déplacé (par exemple, balayer sur le pavé tactile), tandis que les actions sont provoquées par des doigts stationnaires (par exemple, en appuyant ou en appuyant sur le bouton surface du pavé tactile sans déplacer).

Événements

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;

Ces événements sont déclenchés pour les mouvements de style « manipulation ». Ils fonctionnent de la même façon que l’entrée de pointeur est généralement transmise à une application : chaque doigt déclenche PointerPressed, suivi de zéro ou plus PointerMoved, conclu par PointerReleased.

Note

L’entrée de pointeur pour les pavés tactiles présente des différences par rapport à d’autres types d’appareils de pointeur. Pour plus d’informations, consultez les remarques de GetPointerTouchpadInfo .

Note

Bien qu’il soit permis d’utiliser des API Win32 telles que GetPointerInfo pour interroger des informations sur l’entrée du pointeur lors de la gestion de l’un de ces événements, SkipPointerFrameMessages ne doit pas être appelé. TouchpadGesturesController effectue le traitement sur l’entrée en plus de déclencher l’événement et d’ignorer les messages de pointeur peut entraîner son traitement de manière incorrecte.

GlobalActionPerformed

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

Déclenché pour les mouvements de style « action ».

  • [X]FingerTap : déclenché par l’utilisateur effectuant un appui à plusieurs doigts sur le pavé tactile.
  • [X]FingerPress : déclenché par l’utilisateur appuyant sur le bouton surface du pavé tactile avec plusieurs doigts.
  • [X]FingerRelease : déclenché par l’utilisateur libérant le bouton surface du pavé tactile après l’événement ci-dessus.

TouchpadGlobalGestureKinds

[flags]
enum TouchpadGlobalGestureKinds
{
    None                        = 0x0,
    ThreeFingerManipulations    = 0x1,
    FourFingerManipulations     = 0x2,
    FiveFingerManipulations     = 0x4,
    ThreeFingerActions          = 0x8,
    FourFingerActions           = 0x10,
    FiveFingerActions           = 0x20,
};
Valeur Meaning
Aucun (0x0) Aucun mouvement.
ThreeFingerManipulations (0x1) Mouvements de balayage/glisser à trois doigts.
FourFingerManipulations (0x2) Mouvements de balayage/glisser à quatre doigts.
FiveFingerManipulations (0x4) Mouvements de balayage/glisser à cinq doigts.
ThreeFingerActions (0x8) Appuyez sur trois doigts et appuyez sur des mouvements de bouton.
FourFingerActions (0x10) Appuyez sur quatre doigts et appuyez sur des mouvements de bouton.
FiveFingerActions (0x20) Appuyez sur cinq doigts et appuyez sur les mouvements de bouton.

TouchpadGlobalAction

enum TouchpadGlobalAction
{
    ThreeFingerTap,
    FourFingerTap,
    FiveFingerTap,
    ThreeFingerPress,
    FourFingerPress,
    FiveFingerPress,
    ThreeFingerRelease,
    FourFingerRelease,
    FiveFingerRelease,
};
Valeur Meaning
ThreeFingerTap Appuyez sur trois doigts sur le pavé tactile.
FourFingerTap Appuyez sur quatre doigts sur le pavé tactile.
FiveFingerTap Appuyez sur cinq doigts sur le pavé tactile.
ThreeFingerPress Appuyez sur trois doigts sur le bouton surface du pavé tactile.
FourFingerPress Appuyez sur quatre doigts sur le bouton surface du pavé tactile.
FiveFingerPress Appuyez sur cinq doigts sur le bouton surface du pavé tactile.
ThreeFingerRelease Relâchez après une pression à trois doigts.
FourFingerRelease Relâchez après une pression à quatre doigts.
FiveFingerRelease Relâchez après une pression à cinq doigts.

Exigences

Prérequis Valeur
Client minimum requis Windows 11
Namespace Windows. UI. Entrée
Contrat API Windows. Foundation.UniversalApiContract (version 19)
IIDs ITouchpadGesturesController : 28c13cdd-e068-549f-89c6-1a440c6fc327, ITouchpadGesturesControllerStatics : 207ef171-1a73-51cd-a694-8840e09dbafa, ITouchpadGlobalActionEventArgs : 6edad206-e4e3-5f39-9d13-8575e8e2a12b

Voir également

  • Last updated on