InkCollector.SystemGesture, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit lorsqu'un objet InkCollector reconnaît un mouvement système.

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

Syntaxe

'Déclaration
Public Event SystemGesture As InkCollectorSystemGestureEventHandler
'Utilisation
Dim instance As InkCollector
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 et MouseDown entre lesquels aucun autre événement de souris n'intervient, écoutez les mouvements système Tap ou RightTap.

Au lieu d'écouter les événements MouseDown et MouseMove et d'obtenir de nombreux messages MouseMove, vous pouvez également écouter les mouvements système Drag ou RightDrag tant que vous n'avez pas besoin des coordonnées (x, y) de chaque position de la souris. Cela vous permet de recevoir un seul message au lieu de tous les messages MouseMove.

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 Pen Input, Ink, and Recognition .

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 InkCollector, mInkCollector, enregistre le gestionnaire d'événements.

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

// register the SystemGesture event handler
mInkCollector.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.