StylusPointCollection Constructors

Reference

Definition

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Initializes a new instance of the StylusPointCollection class.

Overloads

StylusPointCollection()	Initializes a new instance of the StylusPointCollection class.
StylusPointCollection(IEnumerable<StylusPoint>)	Initializes a new instance of the StylusPointCollection class with the specified StylusPoint objects.
StylusPointCollection(IEnumerable<Point>)	Initializes a new instance of the StylusPointCollection class with specified points.
StylusPointCollection(Int32)	Initializes a new instance of the StylusPointCollection class that may initially contain the specified number of StylusPoint objects.
StylusPointCollection(StylusPointDescription)	Initializes a new instance of the StylusPointCollection class that contains the properties specified in the StylusPointDescription.
StylusPointCollection(StylusPointDescription, Int32)	Initializes a new instance of the StylusPointCollection class that is the specified size and contains the properties specified in the StylusPointDescription.

StylusPointCollection()

Initializes a new instance of the StylusPointCollection class.

public:
 StylusPointCollection();

public StylusPointCollection();

Public Sub New ()

Examples

The following example collects StylusPoint objects in the OnStylusDown method of a custom control. The example creates a StylusPointCollection by specifying the StylusPointDescription and the initial size of the StylusPointCollection.

StylusPointCollection stylusPoints;

protected override void OnStylusDown(StylusDownEventArgs e)
{
    base.OnStylusDown(e);

    StylusPointCollection eventPoints = e.GetStylusPoints(this);

    // Create a new StylusPointCollection using the StylusPointDescription
    // from the stylus points in the StylusDownEventArgs.
    stylusPoints = new StylusPointCollection(eventPoints.Description, eventPoints.Count);
    stylusPoints.Add(eventPoints);
}

Private stylusPoints As StylusPointCollection


Protected Overrides Sub OnStylusDown(ByVal e As StylusDownEventArgs) 
    MyBase.OnStylusDown(e)
    
    Dim eventPoints As StylusPointCollection = e.GetStylusPoints(Me)
    
    ' Create a new StylusPointCollection using the StylusPointDescription
    ' from the stylus points in the StylusDownEventArgs.
    stylusPoints = New StylusPointCollection(eventPoints.Description, eventPoints.Count)
    stylusPoints.Add(eventPoints)

End Sub

Applies to

.NET Framework 4.8.1 and other versions

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

StylusPointCollection(IEnumerable<StylusPoint>)

Initializes a new instance of the StylusPointCollection class with the specified StylusPoint objects.

public:
 StylusPointCollection(System::Collections::Generic::IEnumerable<System::Windows::Input::StylusPoint> ^ stylusPoints);

public StylusPointCollection(System.Collections.Generic.IEnumerable<System.Windows.Input.StylusPoint> stylusPoints);

new System.Windows.Input.StylusPointCollection : seq<System.Windows.Input.StylusPoint> -> System.Windows.Input.StylusPointCollection

Public Sub New (stylusPoints As IEnumerable(Of StylusPoint))

Parameters

stylusPoints: IEnumerable<StylusPoint>

A generic IEnumerable of type StylusPoint to add to the StylusPointCollection.

Exceptions

ArgumentNullException

stylusPoints is null.

ArgumentException

The length of points is 0.

-or-

The StylusPoint objects in stylusPoints have incompatible StylusPointDescription objects.

Examples

The following example creates a StylusPointCollection.

StylusPoint stylusPoint1 =  new StylusPoint(100, 100, .5f);
StylusPoint stylusPoint2 = new StylusPoint(200, 200, .35f);

StylusPointCollection points = new StylusPointCollection(
    new StylusPoint[] { stylusPoint1, stylusPoint2 });

Dim stylusPoint1 As New StylusPoint(100, 100, 0.5F)
Dim stylusPoint2 As New StylusPoint(200, 200, 0.35F)

Dim points As New StylusPointCollection(New StylusPoint() {stylusPoint1, stylusPoint2})

Applies to

.NET Framework 4.8.1 and other versions

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

StylusPointCollection(IEnumerable<Point>)

Initializes a new instance of the StylusPointCollection class with specified points.

public:
 StylusPointCollection(System::Collections::Generic::IEnumerable<System::Windows::Point> ^ points);

public StylusPointCollection(System.Collections.Generic.IEnumerable<System.Windows.Point> points);

new System.Windows.Input.StylusPointCollection : seq<System.Windows.Point> -> System.Windows.Input.StylusPointCollection

Public Sub New (points As IEnumerable(Of Point))

Parameters

points: IEnumerable<Point>

A generic IEnumerable of type Point that specifies the StylusPoint objects to add to the StylusPointCollection.

Exceptions

ArgumentNullException

points is null.

ArgumentException

The length of points is 0.

Examples

The following example creates a StylusPointCollection.

StylusPointCollection points = new StylusPointCollection(new Point[]
    {
        new Point(100, 100),
        new Point(100, 200),
        new Point(200, 250),
        new Point(300, 300)
    });

Dim points As New StylusPointCollection(New Point() _
                        {New Point(100, 100), _
                         New Point(100, 200), _
                         New Point(200, 250), _
                         New Point(300, 300)})

Applies to

.NET Framework 4.8.1 and other versions

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

StylusPointCollection(Int32)

Initializes a new instance of the StylusPointCollection class that may initially contain the specified number of StylusPoint objects.

public:
 StylusPointCollection(int initialCapacity);

public StylusPointCollection(int initialCapacity);

new System.Windows.Input.StylusPointCollection : int -> System.Windows.Input.StylusPointCollection

Public Sub New (initialCapacity As Integer)

Parameters

initialCapacity: Int32

The number of StylusPoint objects the StylusPointCollection can initially contain.

Exceptions

ArgumentException

initialCapacity is negative.

Examples

The following example collects StylusPoint objects in the OnStylusDown method of a custom control. The example creates a StylusPointCollection by specifying both the StylusPointDescription and the initial size of the StylusPointCollection.

StylusPointCollection stylusPoints;

protected override void OnStylusDown(StylusDownEventArgs e)
{
    base.OnStylusDown(e);

    StylusPointCollection eventPoints = e.GetStylusPoints(this);

    // Create a new StylusPointCollection using the StylusPointDescription
    // from the stylus points in the StylusDownEventArgs.
    stylusPoints = new StylusPointCollection(eventPoints.Description, eventPoints.Count);
    stylusPoints.Add(eventPoints);
}

Private stylusPoints As StylusPointCollection


Protected Overrides Sub OnStylusDown(ByVal e As StylusDownEventArgs) 
    MyBase.OnStylusDown(e)
    
    Dim eventPoints As StylusPointCollection = e.GetStylusPoints(Me)
    
    ' Create a new StylusPointCollection using the StylusPointDescription
    ' from the stylus points in the StylusDownEventArgs.
    stylusPoints = New StylusPointCollection(eventPoints.Description, eventPoints.Count)
    stylusPoints.Add(eventPoints)

End Sub

Remarks

When you use the StylusPointCollection constructor to create a new StylusPointCollection, you specify it's initialCapacity. However, you can add more StylusPoint objects by calling the Add method.

Applies to

.NET Framework 4.8.1 and other versions

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

StylusPointCollection(StylusPointDescription)

Initializes a new instance of the StylusPointCollection class that contains the properties specified in the StylusPointDescription.

public:
 StylusPointCollection(System::Windows::Input::StylusPointDescription ^ stylusPointDescription);

public StylusPointCollection(System.Windows.Input.StylusPointDescription stylusPointDescription);

new System.Windows.Input.StylusPointCollection : System.Windows.Input.StylusPointDescription -> System.Windows.Input.StylusPointCollection

Public Sub New (stylusPointDescription As StylusPointDescription)

Parameters

stylusPointDescription: StylusPointDescription

A StylusPointDescription that specifies the additional properties stored in each StylusPoint.

Exceptions

ArgumentNullException

stylusPointDescription is null.

Examples

StylusPointCollection stylusPoints;

protected override void OnStylusDown(StylusDownEventArgs e)
{
    base.OnStylusDown(e);

    StylusPointCollection eventPoints = e.GetStylusPoints(this);

    // Create a new StylusPointCollection using the StylusPointDescription
    // from the stylus points in the StylusDownEventArgs.
    stylusPoints = new StylusPointCollection(eventPoints.Description, eventPoints.Count);
    stylusPoints.Add(eventPoints);
}

Private stylusPoints As StylusPointCollection


Protected Overrides Sub OnStylusDown(ByVal e As StylusDownEventArgs) 
    MyBase.OnStylusDown(e)
    
    Dim eventPoints As StylusPointCollection = e.GetStylusPoints(Me)
    
    ' Create a new StylusPointCollection using the StylusPointDescription
    ' from the stylus points in the StylusDownEventArgs.
    stylusPoints = New StylusPointCollection(eventPoints.Description, eventPoints.Count)
    stylusPoints.Add(eventPoints)

End Sub

Remarks

All StylusPoint objects added to the StylusPointCollection must have a StylusPointDescription that is compatible with stylusPointDescription.

Applies to

.NET Framework 4.8.1 and other versions

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

StylusPointCollection(StylusPointDescription, Int32)

Initializes a new instance of the StylusPointCollection class that is the specified size and contains the properties specified in the StylusPointDescription.

public:
 StylusPointCollection(System::Windows::Input::StylusPointDescription ^ stylusPointDescription, int initialCapacity);

public StylusPointCollection(System.Windows.Input.StylusPointDescription stylusPointDescription, int initialCapacity);

new System.Windows.Input.StylusPointCollection : System.Windows.Input.StylusPointDescription * int -> System.Windows.Input.StylusPointCollection

Public Sub New (stylusPointDescription As StylusPointDescription, initialCapacity As Integer)

Parameters

stylusPointDescription: StylusPointDescription

A StylusPointDescription that specifies the additional properties stored in each StylusPoint.

initialCapacity: Int32

The number of StylusPoint objects the StylusPointCollection can initially contain.

Exceptions

ArgumentException

initialCapacity is negative.

ArgumentNullException

stylusPointDescription is null.

Examples

StylusPointCollection stylusPoints;

protected override void OnStylusDown(StylusDownEventArgs e)
{
    base.OnStylusDown(e);

    StylusPointCollection eventPoints = e.GetStylusPoints(this);

    // Create a new StylusPointCollection using the StylusPointDescription
    // from the stylus points in the StylusDownEventArgs.
    stylusPoints = new StylusPointCollection(eventPoints.Description, eventPoints.Count);
    stylusPoints.Add(eventPoints);
}

Private stylusPoints As StylusPointCollection


Protected Overrides Sub OnStylusDown(ByVal e As StylusDownEventArgs) 
    MyBase.OnStylusDown(e)
    
    Dim eventPoints As StylusPointCollection = e.GetStylusPoints(Me)
    
    ' Create a new StylusPointCollection using the StylusPointDescription
    ' from the stylus points in the StylusDownEventArgs.
    stylusPoints = New StylusPointCollection(eventPoints.Description, eventPoints.Count)
    stylusPoints.Add(eventPoints)

End Sub

Remarks

When you use the StylusPointCollection constructor to create a new StylusPointCollection, the StylusPointCollection is created with the capacity to hold the specified number of StylusPoint objects. You can add more StylusPoint objects than initialCapacity by calling the Add method.

Applies to

.NET Framework 4.8.1 and other versions

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via

StylusPointCollection Constructors

Definition

Overloads

StylusPointCollection()

Examples

Applies to

StylusPointCollection(IEnumerable<StylusPoint>)

Parameters

Exceptions

Examples

Applies to

StylusPointCollection(IEnumerable<Point>)

Parameters

Exceptions

Examples

Applies to

StylusPointCollection(Int32)

Parameters

Exceptions

Examples

Remarks

Applies to

StylusPointCollection(StylusPointDescription)

Parameters

Exceptions

Examples

Remarks

Applies to

StylusPointCollection(StylusPointDescription, Int32)

Parameters

Exceptions

Examples

Remarks

Applies to

Additional resources