InkPicture.SystemGesture, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit lorsqu'un mouvement système est reconnu.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Event SystemGesture As InkCollectorSystemGestureEventHandler
'Utilisation
Dim instance As InkPicture
Dim handler As InkCollectorSystemGestureEventHandler

AddHandler instance.SystemGesture, handler

public event InkCollectorSystemGestureEventHandler SystemGesture

public:
 event InkCollectorSystemGestureEventHandler^ SystemGesture {
    void add (InkCollectorSystemGestureEventHandler^ value);
    void remove (InkCollectorSystemGestureEventHandler^ value);
}

/** @event */
public void add_SystemGesture (InkCollectorSystemGestureEventHandler value)
/** @event */
public void remove_SystemGesture (InkCollectorSystemGestureEventHandler value)

JScript ne prend pas en charge les événements.

Notes

Les mouvements système fournissent des informations sur l'objet Cursor utilisé pour créer le mouvement. Ils servent également de raccourcis pour les combinaisons d'événements de souris et permettent de détecter efficacement des événements de souris.

Par exemple, au lieu d'écouter une paire d'événements MouseUp (page pouvant être en anglais) et MouseDown (page pouvant être en anglais) sans que d'autres événements de souris se déclenchent entre temps, vous pouvez écoutez les mouvements système Tap ou RightTap.

Autre exemple : au lieu d'écouter les événements MouseDown (page pouvant être en anglais) et MouseMove (page pouvant être en anglais) et recevoir de nombreux messages MouseMove (page pouvant être en anglais), vous pouvez écouter les mouvements système Drag ou RightDrag, tant que vous n'avez pas besoin des coordonnées (x, y) de toutes les positions de la souris. Cela vous permet de recevoir un seul message au lieu de tous les messages MouseMove (page pouvant être en anglais).

Pour obtenir la liste des mouvements système spécifiques, consultez le type énumération SystemGesture. Pour plus d'informations sur les mouvements système, consultez Using Gestures et Command Input on the Tablet PC.

Le gestionnaire d'événements reçoit un argument de type InkCollectorSystemGestureEventArgs qui contient des données concernant cet événement.

Lorsque vous créez un délégué InkCollectorSystemGestureEventHandler, vous identifiez la méthode qui gère l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué.

Exemples

Dans cet exemple, le gestionnaire d'événements affiche des informations sur les mouvements système sur une étiquette de barre d'état, statusLabelSysGesture.

Private Sub Event_OnSystemGesture(ByVal sender As Object, ByVal e As InkCollectorSystemGestureEventArgs)
    Select Case e.Id
        Case SystemGesture.Tap
            Me.statusLabelSysGesture.Text = "Tap"
        Case SystemGesture.DoubleTap
            Me.statusLabelSysGesture.Text = "Double Tap"

    End Select
End Sub

private void Event_OnSystemGesture(object sender, InkCollectorSystemGestureEventArgs e)
{
    switch (e.Id)
    {
        case SystemGesture.Tap:
            this.statusLabelSysGesture.Text = "Tap";
            break;
        case SystemGesture.DoubleTap:
            this.statusLabelSysGesture.Text = "Double Tap";
            break;
    }

}

Avant la collecte des mouvements système, l'objet InkPicture, mInkPicture, enregistre le gestionnaire d'événements.

' register the SystemGesture event handler
AddHandler mInkPicture.SystemGesture, New InkCollectorSystemGestureEventHandler(AddressOf Event_OnSystemGesture)

// register the SystemGesture event handler
mInkPicture.SystemGesture += new InkCollectorSystemGestureEventHandler(Event_OnSystemGesture);

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.