Interceptando entrada na caneta
A System.Windows.Input.StylusPlugIns arquitetura fornece um mecanismo para implementar o controle de baixo nível sobre Stylus a entrada e a criação de objetos de tinta Stroke digital. A StylusPlugIn classe fornece um mecanismo para você implementar o comportamento personalizado e aplicá-lo ao fluxo de dados provenientes do dispositivo da caneta para o desempenho ideal.
Este tópico contém as seguintes subseções:
Arquitetura
A StylusPlugIn é a evolução das APIs StylusInput, descritas em Acessando e manipulando a entrada de caneta.
Cada UIElement um tem uma propriedade que é um StylusPlugInsStylusPlugInCollectionarquivo . Você pode adicionar um à propriedade de um StylusPlugIn elemento para manipular StylusPoint dados StylusPlugIns à medida que são gerados. StylusPoint Os dados consistem em todas as propriedades suportadas pelo digitalizador do sistema, incluindo os X dados e Y Point, bem como PressureFactor dados.
Seus StylusPlugIn objetos são inseridos diretamente no fluxo de dados provenientes do Stylus dispositivo quando você adiciona o StylusPlugIn à StylusPlugIns propriedade. A ordem em que os plug-ins são adicionados à coleção determina a ordem em que eles receberão StylusPoint os StylusPlugIns dados. Por exemplo, se você adicionar um plug-in de filtro que restrinja a entrada a uma região específica e, em seguida, adicionar um plug-in que reconheça gestos à medida que eles são gravados, o plug-in que reconhece gestos receberá dados filtrados StylusPoint .
Implementando plug-ins de caneta
Para implementar um plug-in, derive uma classe de StylusPlugIn. Essa classe é aplicada ao fluxo de dados à medida que ele vem do Stylus. Nesta classe você pode modificar os StylusPoint valores dos dados.
Cuidado
Se um StylusPlugIn lançar ou causar uma exceção, o aplicativo será fechado. Você deve testar completamente os controles que consomem um e só usar um StylusPlugIn controle se tiver certeza de que o StylusPlugIn não lançará uma exceção.
O exemplo a seguir demonstra um plug-in que restringe a entrada da caneta modificando os X valores e Y nos StylusPoint dados à medida que eles vêm do Stylus dispositivo.
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
Adicionando seu plug-in a uma InkCanvas
A maneira mais fácil de usar seu plug-in personalizado é implementar uma classe derivada do InkCanvas e adicioná-la à StylusPlugIns propriedade.
O exemplo a seguir demonstra um personalizado InkCanvas que filtra a tinta.
public class FilterInkCanvas : InkCanvas
{
FilterPlugin filter = new FilterPlugin();
public FilterInkCanvas()
: base()
{
this.StylusPlugIns.Add(filter);
}
}
Se você adicionar um FilterInkCanvas
ao seu aplicativo e executá-lo, observará que a tinta não fica restrita a uma região até após o usuário concluir um traço. Isso porque o InkCanvas tem um imóvel, que é um StylusPlugInDynamicRenderer e já é membro do StylusPlugIns acervo. O personalizado StylusPlugIn que você adicionou à StylusPlugIns coleção recebe os dados depois DynamicRenderer de receber os StylusPoint dados. Como resultado, os StylusPoint dados não serão filtrados até que o usuário levante a caneta para encerrar um traço. Para filtrar a tinta à medida que o usuário a desenha, você deve inserir o antes do FilterPlugin
DynamicRenderer.
O código C# a seguir demonstra um personalizado InkCanvas que filtra a tinta à medida que ela é desenhada.
public class DynamicallyFilteredInkCanvas : InkCanvas
{
FilterPlugin filter = new FilterPlugin();
public DynamicallyFilteredInkCanvas()
: base()
{
int dynamicRenderIndex =
this.StylusPlugIns.IndexOf(this.DynamicRenderer);
this.StylusPlugIns.Insert(dynamicRenderIndex, filter);
}
}
Conclusão
Ao derivar suas próprias StylusPlugIn classes e inseri-las em StylusPlugInCollection coleções, você pode melhorar muito o comportamento de sua tinta digital. Você tem acesso aos StylusPoint dados à medida que são gerados, dando-lhe a oportunidade de personalizar a Stylus entrada. Como você tem acesso de baixo nível aos dados, pode implementar a coleta de tinta e a StylusPoint renderização com desempenho ideal para seu aplicativo.
Confira também
.NET Desktop feedback