Artigo
11/18/2011

StylusDevice.GetStylusPoints Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns the stylus points collected since the last mouse event.

Namespace: System.Windows.Input
Assembly: System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public Function GetStylusPoints ( _
    relativeTo As UIElement _
) As StylusPointCollection

public StylusPointCollection GetStylusPoints(
    UIElement relativeTo
)

Parameters

relativeTo
Type: System.Windows.UIElement
Specifies the offset for the object (typically an InkPresenter) that should be applied to captured points.

Return Value

Type: System.Windows.Input.StylusPointCollection
A collection of the stylus points collected since the last mouse event.

Remarks

The coordinates of the returned StylusPointCollection points are relative to the InkPresenter or other UIElement that is passed into this method.

If the active device is a mouse (DeviceType returns TabletDeviceType.Mouse), the returned StylusPointCollection contains a single point that corresponds to the mouse event.

Examples

The following code snippet iterates through stylus points of the strokes drawn in the first InkPresenter control to display its mirror image in the second InkPresenter control.

    Private MyStroke As Stroke

    Public Sub New()
        MyBase.New()
        InitializeComponent()
        SetBoundaryForIP1()
        SetBoundaryForIP2()
    End Sub

    'A new stroke object, MyStroke, is created and is added to the StrokeCollection object
    'of the InkPresenter, MyIP1
    Private Sub MyIP1_MouseLeftButtonDown(ByVal sender As Object, ByVal e As MouseEventArgs)
        MyIP1.CaptureMouse()
        Dim MyStylusPointCollection As StylusPointCollection = New StylusPointCollection
        MyStylusPointCollection.Add(e.StylusDevice.GetStylusPoints(MyIP1))
        MyStroke = New Stroke(MyStylusPointCollection)
        MyIP1.Strokes.Add(MyStroke)
    End Sub

    'StylusPoint objects are collected from the MouseEventArgs and added to MyStroke
    Private Sub MyIP1_MouseMove(ByVal sender As Object, ByVal e As MouseEventArgs)
        If (Not (MyStroke) Is Nothing) Then
            MyStroke.StylusPoints.Add(e.StylusDevice.GetStylusPoints(MyIP1))
        End If
    End Sub

    'MyStroke is completed
    Private Sub MyIP1_LostMouseCapture(ByVal sender As Object, ByVal e As MouseEventArgs)
        MyStroke = Nothing
    End Sub

    'Create the mirror image of the stroke collection in MyIP1 and adding it to MyIP2
    Private Sub BtMirror_Click(ByVal sender As Object, ByVal e As EventArgs)
        'Iterate through the Strokes in the StrokeCollection of MyIP1
        For Each stroke As Stroke In MyIP1.Strokes
            Dim newcollection As StylusPointCollection = New StylusPointCollection
            'Iterate through the stylus points of each stroke in MyIP1
            For Each p As StylusPoint In stroke.StylusPoints
                'Create the mirror image
                Dim newpoint As StylusPoint = New StylusPoint
                newpoint.X = (MyIP1.ActualWidth - p.X)
                newpoint.Y = p.Y
                newcollection.Add(newpoint)
            Next
            'Add the mirror image to MyIP2
            Dim newStroke As Stroke = New Stroke(newcollection)
            MyIP2.Strokes.Add(newStroke)
        Next
    End Sub

Stroke MyStroke;

//A new stroke object named MyStroke is created. MyStroke is added to the StrokeCollection of the InkPresenter named MyIP1
private void MyIP1_MouseLeftButtonDown(object sender, MouseEventArgs e)
{
    MyIP1.CaptureMouse();
    StylusPointCollection MyStylusPointCollection = new StylusPointCollection();
    MyStylusPointCollection.Add(e.StylusDevice.GetStylusPoints(MyIP1));
    MyStroke = new Stroke(MyStylusPointCollection);
    MyIP1.Strokes.Add(MyStroke);
}

//StylusPoint objects are collected from the MouseEventArgs and added to MyStroke
private void MyIP1_MouseMove(object sender, MouseEventArgs e)
{
    if (MyStroke != null)
        MyStroke.StylusPoints.Add(e.StylusDevice.GetStylusPoints(MyIP1));
}

//MyStroke is completed
private void MyIP1_LostMouseCapture(object sender, MouseEventArgs e)
{
    MyStroke = null;
}

//Create the mirror image of the stroke collection in MyIP1 and adding it to MyIP2
private void BtMirror_Click(object sender, EventArgs e)
{
    //Iterate through the Strokes in the StrokeCollection of MyIP1
    foreach (Stroke stroke in MyIP1.Strokes)
    {
        StylusPointCollection newcollection = new StylusPointCollection();
        //Iterate through the stylus points of each stroke in MyIP1
        foreach (StylusPoint p in stroke.StylusPoints)
        {
            //Create the mirror image
            StylusPoint newpoint = new StylusPoint();
            newpoint.X = MyIP1.ActualWidth - p.X;
            newpoint.Y = p.Y;
            newcollection.Add(newpoint);
        }
        //Add the mirror image to MyIP2
        Stroke newStroke = new Stroke(newcollection);
        MyIP2.Strokes.Add(newStroke);
    }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Compartilhar via