StylusPlugIn.OnStylusDown Method (RawStylusInput)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Occurs on a thread in the pen thread pool when the tablet pen touches the digitizer.

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

protected virtual void OnStylusDown(
	RawStylusInput rawStylusInput


Type: System.Windows.Input.StylusPlugIns.RawStylusInput

A RawStylusInput that contains information about input from the pen.

This method occurs on a pen thread, so minimize work in this method to avoid impacting performance.

The following example demonstrates how to override the OnStylusDown method. To create a StylusPlugIn that restricts ink to a certain area, see the StylusPlugIn overview.

protected override void OnStylusDown(RawStylusInput rawStylusInput)
    // Run the base class before modifying the data

    // 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

.NET Framework
Available since 3.0
Return to top