Export (0) Print
Expand All

StylusPlugIn.OnStylusLeave Method

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

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft