InkStrokeBuilder InkStrokeBuilder InkStrokeBuilder InkStrokeBuilder Class

Builds strokes from raw pointer input.

Note

For Universal Windows app using Extensible Application Markup Language (XAML), we recommend using InkPresenter and the InkCanvas control instead of InkManager.

Use CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>) and SetDefaultDrawingAttributes(InkDrawingAttributes) to programmatically build strokes for an InkPresenter.

Syntax

Declaration

public sealed class InkStrokeBuilderpublic sealed class InkStrokeBuilderPublic NotInheritable Class InkStrokeBuilderpublic sealed class InkStrokeBuilder

Remarks

Note

: This class is not agile, which means that you need to consider its threading model and marshaling behavior. For more info, see Threading and Marshaling (C++/CX) and Using Windows Runtime objects in a multithreaded environment (.NET).

Constructors summary

Creates a new InkStrokeBuilder object that is used to construct InkStroke objects.

Note

For Universal Windows app using Extensible Application Markup Language (XAML), we recommend using InkPresenter and the InkCanvas control instead of InkManager.

Use CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>) and SetDefaultDrawingAttributes(InkDrawingAttributes) to programmatically build strokes for an InkPresenter.

Methods summary

Adds a new segment to the ink stroke.

AppendToStroke(PointerPoint) is called after BeginStroke(PointerPoint) and before EndStroke(PointerPoint) during the InkStroke building process.

Starts building the ink stroke.

Creates a stroke from an array of Point coordinates.

Creates a basic ink stroke from collection of InkPoint objects.

Prerelease. Creates a rich ink stroke from collection of InkPoint objects.

Stops building the ink stroke.

Sets the default InkDrawingAttributes for all new ink strokes created after the current stroke.

SetDefaultDrawingAttributes(InkDrawingAttributes) does not affect the current stroke, or any existing strokes.

Note

Use SetDefaultDrawingAttributes(InkDrawingAttributes) when programmatically building strokes for both InkPresenter and InkManager objects.

Constructors

Methods

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.DualApiPartitionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.ThreadingAttribute

Details

Assembly

Windows.UI.Input.Inking.dll