OnStylusLeave Method

StylusPlugIn.OnStylusLeave Method (RawStylusInput, Boolean)

 

Occurs on a pen thread when the cursor leaves the bounds of an element.

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

protected virtual void OnStylusLeave(
	RawStylusInput rawStylusInput,
	bool confirmed
)

Parameters

rawStylusInput
Type: System.Windows.Input.StylusPlugIns.RawStylusInput

A RawStylusInput that contains information about input from the pen.

confirmed
Type: System.Boolean

true if the pen actually left the bounds of the element; otherwise, false.

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

The following example resets the StylusPlugIn when the cursor leaves the bounds of the element.

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

.NET Framework
Available since 3.0
Return to top
Show:
© 2016 Microsoft