Evento InkCollector.SystemGesture

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando un oggetto InkCollector riconosce un movimento del sistema.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Event SystemGesture As InkCollectorSystemGestureEventHandler
'Utilizzo
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 non supporta gli eventi.

Note

I movimenti del sistema forniscono informazioni sull'oggetto Cursor utilizzato per creare il movimento. Forniscono inoltre collegamenti a combinazioni di eventi del mouse e costituiscono un modo efficace per rilevare gli eventi del mouse.

Ad esempio, anziché rimanere in ascolto di una coppia di eventi MouseUp e MouseDown non intercalati da altri eventi del mouse, attendere i movimenti del sistema Tap o RightTap.

Come ulteriore esempio, anziché rimanere in ascolto degli eventi MouseDown e MouseMove e ottenere numerosi messaggi MouseMove, è possibile attendere i movimenti del sistema Drag o RightDrag se le coordinate (X, Y) di ciascuna posizione del mouse non sono necessarie. Ciò consente di ricevere un solo messaggio anziché numerosi messaggi MouseMove.

Per un elenco di movimenti specifici del sistema, vedere il tipo di enumerazione SystemGesture. Per ulteriori informazioni sui movimenti del sistema, vedere Pen Input, Ink, and Recognition.

Il gestore eventi riceve un argomento di tipo InkCollectorSystemGestureEventArgs contenente i dati relativi a questo evento.

Quando si crea un delegato InkCollectorSystemGestureEventHandler, viene identificato il metodo che gestisce l'evento. Per associare l'evento al gestore in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non si rimuova il delegato.

Esempi

Il gestore eventi di questo esempio visualizza informazioni relative ai movimenti del sistema su un'etichetta della barra di stato, 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;
    }

}

Prima della raccolta di movimenti del sistema, l'oggetto InkCollector, mInkCollector registra il gestore eventi.

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

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.