RawStylusInput Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona información sobre la entrada de un objeto StylusDevice a StylusPlugIn.
public ref class RawStylusInput
public class RawStylusInput
type RawStylusInput = class
Public Class RawStylusInput
- Herencia
-
RawStylusInput
Ejemplos
En el ejemplo siguiente se crea un StylusPlugIn objeto que comprueba el Down gesto. Llama StylusPlugIn NotifyWhenProcessed a en OnStylusUp para suscribirse al OnStylusUpProcessed método , al que se llama desde el subproceso de la aplicación.
class RecognizerPlugin : StylusPlugIn
{
GestureRecognizer recognizer;
// StylusPointCollection that contains the stylus points of the current
// stroke.
StylusPointCollection points;
// Keeps track of the stylus to check whether two styluses are used on the
// digitizer.
int currentStylus;
public RecognizerPlugin()
: base()
{
recognizer = new GestureRecognizer();
}
// Collect the points as the user draws the stroke.
protected override void OnStylusDown(RawStylusInput rawStylusInput)
{
// If points is not null, there is already a stroke taking place
// on the digitizer, so don't create a new StylusPointsCollection.
if (points == null)
{
points = new StylusPointCollection(rawStylusInput.GetStylusPoints().Description);
points.Add(rawStylusInput.GetStylusPoints());
currentStylus = rawStylusInput.StylusDeviceId;
}
}
// Collect the points as the user draws the stroke.
protected override void OnStylusMove(RawStylusInput rawStylusInput)
{
// Check whether the stylus that started the stroke is the same, and
// that the element hasn't lost focus since the stroke began.
if (points != null && currentStylus == rawStylusInput.StylusDeviceId)
{
points.Add(rawStylusInput.GetStylusPoints());
}
}
// Collect the points as the user draws the stroke.
protected override void OnStylusUp(RawStylusInput rawStylusInput)
{
// Check whether the stylus that started the stroke is the same, and
// that the element hasn't lost focus since the stroke began.
if (points != null && currentStylus == rawStylusInput.StylusDeviceId)
{
points.Add(rawStylusInput.GetStylusPoints());
// Subscribe to the OnStylusUpProcessed method.
rawStylusInput.NotifyWhenProcessed(points);
}
points = null;
currentStylus = 0;
}
// If the element loses focus, stop collecting the points and don't
// perform gesture recognition.
protected override void OnStylusLeave(RawStylusInput rawStylusInput, bool confirmed)
{
if (confirmed)
{
// Clear the StylusPointCollection
points = null;
currentStylus = 0;
}
}
// This method is called on the application thread.
protected override void OnStylusUpProcessed(object callbackData, bool targetVerified)
{
// Check that the element actually receive the OnStylusUp input.
if (targetVerified && recognizer.IsRecognizerAvailable)
{
StylusPointCollection strokePoints = callbackData as StylusPointCollection;
if (strokePoints == null)
{
return;
}
// Create a StrokeCollection to pass to the GestureRecognizer.
Stroke newStroke = new Stroke(strokePoints);
StrokeCollection strokes = new StrokeCollection();
strokes.Add(newStroke);
ReadOnlyCollection<GestureRecognitionResult> results = recognizer.Recognize(strokes);
// If the GestureRecognizer recognizes the stroke as a Down
// gesture with strong confidence, raise an event.
if (results[0].ApplicationGesture == ApplicationGesture.Down &&
results[0].RecognitionConfidence == RecognitionConfidence.Strong)
{
//raise event
}
}
}
}
Class RecognizerPlugin
Inherits StylusPlugIn
Private recognizer As GestureRecognizer
' StylusPointCollection that contains the stylus points of the current
' stroke.
Private points As StylusPointCollection
' Keeps track of the stylus to check whether two styluses are used on the
' digitizer.
Private currentStylus As Integer
Public Sub New()
recognizer = New GestureRecognizer()
End Sub
' Collect the points as the user draws the stroke.
Protected Overrides Sub OnStylusDown(ByVal rawStylusInput As RawStylusInput)
' If points is not null, there is already a stroke taking place
' on the digitizer, so don't create a new StylusPointsCollection.
If points Is Nothing Then
points = New StylusPointCollection(rawStylusInput.GetStylusPoints().Description)
points.Add(rawStylusInput.GetStylusPoints())
currentStylus = rawStylusInput.StylusDeviceId
End If
End Sub
' Collect the points as the user draws the stroke.
Protected Overrides Sub OnStylusMove(ByVal rawStylusInput As RawStylusInput)
' Check whether the stylus that started the stroke is the same, and
' that the element hasn't lost focus since the stroke began.
If Not (points Is Nothing) AndAlso currentStylus = rawStylusInput.StylusDeviceId Then
points.Add(rawStylusInput.GetStylusPoints())
End If
End Sub
' Collect the points as the user draws the stroke.
Protected Overrides Sub OnStylusUp(ByVal rawStylusInput As RawStylusInput)
' Check whether the stylus that started the stroke is the same, and
' that the element hasn't lost focus since the stroke began.
If Not (points Is Nothing) AndAlso currentStylus = rawStylusInput.StylusDeviceId Then
points.Add(rawStylusInput.GetStylusPoints())
' Subscribe to the OnStylusUpProcessed method.
rawStylusInput.NotifyWhenProcessed(points)
End If
points = Nothing
currentStylus = 0
End Sub
' If the element loses focus, stop collecting the points and don't
' perform gesture recognition.
Protected Overrides Sub OnStylusLeave(ByVal rawStylusInput As RawStylusInput, ByVal confirmed As Boolean)
If confirmed Then
' Clear the StylusPointCollection
points = Nothing
currentStylus = 0
End If
End Sub
' This method is called on the application thread.
Protected Overrides Sub OnStylusUpProcessed(ByVal callbackData As Object, ByVal targetVerified As Boolean)
' Check that the element actually receive the OnStylusUp input.
If targetVerified AndAlso recognizer.IsRecognizerAvailable Then
Dim strokePoints As StylusPointCollection = callbackData
If strokePoints Is Nothing Then
Return
End If
' Create a StrokeCollection to pass to the GestureRecognizer.
Dim newStroke As New Stroke(strokePoints)
Dim strokes As New StrokeCollection()
strokes.Add(newStroke)
Dim results As ReadOnlyCollection(Of GestureRecognitionResult) = recognizer.Recognize(strokes)
' If the GestureRecognizer recognizes the stroke as a Down
' gesture with strong confidence, raise an event.
If results(0).ApplicationGesture = ApplicationGesture.Down AndAlso _
results(0).RecognitionConfidence = RecognitionConfidence.Strong Then
'raise event
End If
End If
End Sub
End Class
Comentarios
RawStylusInput Use para obtener información sobre la entrada que StylusPlugIn recibe cuando el usuario mueve el lápiz óptico.
Propiedades
StylusDeviceId |
Obtiene el identificador del dispositivo de lápiz óptico actual. |
TabletDeviceId |
Obtiene el identificador del dispositivo de tableta gráfica actual. |
Timestamp |
Obtiene la hora en la que se produjo la entrada. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetStylusPoints() |
Obtiene los puntos del lápiz óptico recopilados a partir del lápiz óptico. |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
NotifyWhenProcessed(Object) |
Se suscribe a los métodos del lápiz óptico correspondientes del subproceso de la aplicación. |
SetStylusPoints(StylusPointCollection) |
Establece los puntos del lápiz óptico que se pasan al subproceso de la aplicación. |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |