InkPicture.SystemGesture (Evento)

Artículo
11/26/2008

Actualización: noviembre 2007

Se produce cuando se reconoce un movimiento del sistema.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Event SystemGesture As InkCollectorSystemGestureEventHandler
'Uso
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 no admite eventos.

Comentarios

Los movimientos del sistema proporcionan información sobre el objeto Cursor que se usa para crear el movimiento. También proporcionan accesos directos a combinaciones de eventos del mouse y constituyen mecanismos eficaces para la detección de eventos del mouse.

Por ejemplo, en lugar de realizar escuchas para un par de eventos MouseUp y MouseDown sin que se produzcan entretanto otros eventos del mouse, puede realizar escuchas para los movimientos del sistema Tap o RightTap.

Como otro ejemplo, en lugar de realizar escuchas para los eventos MouseUp y MouseDown y obtener numerosos mensajes MouseMove, puede realizar escuchas para los movimientos del sistema Drag o RightDrag, con tal de que no necesite las coordenadas (x, y) de cada posición del mouse. Esto le permite recibir un único mensaje MouseMove en lugar de muchos de ellos.

Para obtener una lista de los movimientos específicos del sistema, vea el tipo de enumeración SystemGesture. Para obtener más información acerca de los movimientos del sistema, vea Using Gestures y Command Input on the Tablet PC.

El controlador de eventos recibe un argumento de tipo InkCollectorSystemGestureEventArgs que contiene datos sobre este evento.

Cuando se crea un delegado de InkCollectorSystemGestureEventHandler, se identifica el método que controla el evento. Para asociarlo al controlador de eventos, se debe agregar al evento una instancia del delegado. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado.

Ejemplos

El controlador de eventos de este ejemplo muestra información sobre los movimientos del sistema en una etiqueta de la barra de estado, 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;
    }

}

Antes de la recopilación de movimientos del sistema, el objeto InkPicture, mInkPicture registra el controlador de eventos.

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

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.