Interceptar entradas del lápiz óptico

  • Artículo

La arquitectura System.Windows.Input.StylusPlugIns proporciona un mecanismo para implementar un control de bajo nivel sobre la entrada Stylus y la creación de objetos de entrada de lápiz digital Stroke. La clase StylusPlugIn proporciona un mecanismo para que implemente un comportamiento personalizado y lo aplique al flujo de datos procedentes del dispositivo del lápiz óptico para el rendimiento óptimo.

Este tema contiene las siguientes subsecciones:

Arquitectura

El StylusPlugIn es la evolución de las API StylusInput, que se describen en Acceso y manipulación de la entrada del lápiz.

Cada UIElement tiene una propiedad StylusPlugIns que es una StylusPlugInCollection. Puede agregar un StylusPlugIn a la propiedad StylusPlugIns de un elemento para manipular los datos de StylusPoint a medida que se generan. Los datos de StylusPoint constan de todas las propiedades admitidas por el digitalizador del sistema, incluidos los X y los datos de punto Y, así como los datos de PressureFactor.

Los objetos StylusPlugIn se insertan directamente en el flujo de datos procedentes del dispositivo Stylus cuando se agrega el StylusPlugIn a la propiedad StylusPlugIns. El orden en que se agregan complementos a la colección StylusPlugIns determina el orden en el que recibirán datos de StylusPoint. Por ejemplo, si agrega un complemento de filtro que restringe la entrada a una región determinada y, a continuación, agrega un complemento que reconoce los gestos a medida que se escriben, el complemento que reconoce los gestos recibirá datos filtrados de StylusPoint.

Implementación de complementos de lápiz óptico

Para implementar un complemento, derive una clase de StylusPlugIn. Esta clase se aplica al flujo de datos a medida que se agregan desde Stylus. En esta clase puede modificar los valores de los datos de StylusPoint.

Precaución

Si un StylusPlugIn tiene o produce una excepción, se cerrará la aplicación. Debe probar exhaustivamente los controles que consumen un StylusPlugIn y solo usar un control si está seguro de que el StylusPlugIn no producirá una excepción.

En el ejemplo siguiente se muestra un complemento que restringe la entrada del lápiz óptico modificando los valores X y Y de los datos StylusPoint a medida que se obtienen del dispositivo Stylus.

using System;
using System.Windows.Media;
using System.Windows;
using System.Windows.Input.StylusPlugIns;
using System.Windows.Input;
using System.Windows.Ink;

Imports System.Windows.Media
Imports System.Windows
Imports System.Windows.Input.StylusPlugIns
Imports System.Windows.Input
Imports System.Windows.Ink

// A StylusPlugin that restricts the input area.
class FilterPlugin : StylusPlugIn
{
    protected override void OnStylusDown(RawStylusInput rawStylusInput)
    {
        // Call the base class before modifying the data.
        base.OnStylusDown(rawStylusInput);

        // Restrict the stylus input.
        Filter(rawStylusInput);
    }

    protected override void OnStylusMove(RawStylusInput rawStylusInput)
    {
        // Call the base class before modifying the data.
        base.OnStylusMove(rawStylusInput);

        // Restrict the stylus input.
        Filter(rawStylusInput);
    }

    protected override void OnStylusUp(RawStylusInput rawStylusInput)
    {
        // Call the base class before modifying the data.
        base.OnStylusUp(rawStylusInput);

        // Restrict the stylus input
        Filter(rawStylusInput);
    }

    private void Filter(RawStylusInput rawStylusInput)
    {
        // Get the StylusPoints that have come in.
        StylusPointCollection stylusPoints = rawStylusInput.GetStylusPoints();

        // Modify the (X,Y) data to move the points
        // inside the acceptable input area, if necessary.
        for (int i = 0; i < stylusPoints.Count; i++)
        {
            StylusPoint sp = stylusPoints[i];
            if (sp.X < 50) sp.X = 50;
            if (sp.X > 250) sp.X = 250;
            if (sp.Y < 50) sp.Y = 50;
            if (sp.Y > 250) sp.Y = 250;
            stylusPoints[i] = sp;
        }

        // Copy the modified StylusPoints back to the RawStylusInput.
        rawStylusInput.SetStylusPoints(stylusPoints);
    }
}

' A StylusPlugin that restricts the input area.
Class FilterPlugin
    Inherits StylusPlugIn

    Protected Overrides Sub OnStylusDown(ByVal rawStylusInput As RawStylusInput)
        ' Call the base class before modifying the data.
        MyBase.OnStylusDown(rawStylusInput)

        ' Restrict the stylus input.
        Filter(rawStylusInput)

    End Sub


    Protected Overrides Sub OnStylusMove(ByVal rawStylusInput As RawStylusInput)
        ' Call the base class before modifying the data.
        MyBase.OnStylusMove(rawStylusInput)

        ' Restrict the stylus input.
        Filter(rawStylusInput)

    End Sub


    Protected Overrides Sub OnStylusUp(ByVal rawStylusInput As RawStylusInput)
        ' Call the base class before modifying the data.
        MyBase.OnStylusUp(rawStylusInput)

        ' Restrict the stylus input
        Filter(rawStylusInput)

    End Sub


    Private Sub Filter(ByVal rawStylusInput As RawStylusInput)
        ' Get the StylusPoints that have come in.
        Dim stylusPoints As StylusPointCollection = rawStylusInput.GetStylusPoints()

        ' Modify the (X,Y) data to move the points 
        ' inside the acceptable input area, if necessary.
        Dim i As Integer
        For i = 0 To stylusPoints.Count - 1
            Dim sp As StylusPoint = stylusPoints(i)
            If sp.X < 50 Then
                sp.X = 50
            End If
            If sp.X > 250 Then
                sp.X = 250
            End If
            If sp.Y < 50 Then
                sp.Y = 50
            End If
            If sp.Y > 250 Then
                sp.Y = 250
            End If
            stylusPoints(i) = sp
        Next i

        ' Copy the modified StylusPoints back to the RawStylusInput.
        rawStylusInput.SetStylusPoints(stylusPoints)

    End Sub
End Class

Agregar el complemento a InkCanvas

La manera más fácil de usar el complemento personalizado es implementar una clase que deriva de InkCanvas y agregarla a la propiedad StylusPlugIns.

En el ejemplo siguiente se muestra un InkCanvas personalizado que filtra la entrada de lápiz.

public class FilterInkCanvas : InkCanvas
{
    FilterPlugin filter = new FilterPlugin();

    public FilterInkCanvas()
        : base()
    {
        this.StylusPlugIns.Add(filter);
    }
}

Si agrega un elemento FilterInkCanvas a la aplicación y lo ejecuta, observará que la entrada de lápiz no está restringida a una región hasta que el usuario complete un trazo. Esto se debe a que InkCanvas tiene una propiedad DynamicRenderer, que es un StylusPlugIn y ya es miembro de la colección StylusPlugIns. El StylusPlugIn personalizado que agregó a la colección StylusPlugIns recibe los datos de StylusPoint después de que DynamicRenderer reciba datos. Como resultado, los datos de StylusPoint no se filtrarán hasta después de que el usuario levante el lápiz para finalizar un trazo. Para filtrar la entrada de lápiz a medida que el usuario la dibuja, debe insertar el FilterPlugin antes de DynamicRenderer.

El siguiente código de C# muestra un InkCanvas personalizado que filtra la entrada de lápiz a medida que se dibuja.

public class DynamicallyFilteredInkCanvas : InkCanvas
{
    FilterPlugin filter = new FilterPlugin();

    public DynamicallyFilteredInkCanvas()
        : base()
    {
        int dynamicRenderIndex =
            this.StylusPlugIns.IndexOf(this.DynamicRenderer);

        this.StylusPlugIns.Insert(dynamicRenderIndex, filter);
    }
}

Conclusión

Al derivar sus propias clases StylusPlugIn e insertarlas en colecciones StylusPlugInCollection, puede mejorar considerablemente el comportamiento de la entrada de lápiz digital. Tiene acceso a los datos de StylusPointa medida que se generan, lo que le da la oportunidad de personalizar la entrada de Stylus. Dado el acceso de bajo nivel a los datos de StylusPoint, podrá implementar la colección de entrada de lápiz y representarla con un rendimiento óptimo para la aplicación.

Vea también