InkCollector.SystemGesture (Evento)

Artículo
11/26/2008

Actualización: noviembre 2007

Se produce cuando un objeto InkCollector 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 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 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 produzca ningún otro evento del mouse entre medias, realice escuchas para los movimientos del sistema Tap o RightTap.

Otro ejemplo: en lugar de realizar escuchas para los eventos MouseMove y MouseDown y obtener numerosos mensajes MouseMove, puede realizar escuchas para los movimientos del sistema Drag o RightDrag, siempre que no necesite las coordenadas (X, Y) de cada posición del mouse. Esto le permitirá recibir un único mensaje en lugar de numerosos mensajes MouseMove.

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

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 InkCollector, mInkCollector registra el controlador de eventos.

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

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