Evento InkPicture.SystemGesture

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando viene riconosciuto 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 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 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 MouseUpe MouseDownnon intercalati da altri eventi del mouse, è possibile attendere i movimenti del sistema Tap o RightTap.

Come ulteriore esempio, anziché rimanere in ascolto degli eventi MouseDowne 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 Using Gestures e Command Input on the Tablet PC.

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 InkPicture, mInkPicture registra il gestore eventi.

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

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