InkStrokeBuilder InkStrokeBuilder InkStrokeBuilder InkStrokeBuilder InkStrokeBuilder Class

Definition

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 and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

public : sealed class InkStrokeBuilder : IInkStrokeBuilder, IInkStrokeBuilder2, IInkStrokeBuilder3
struct winrt::Windows::UI::Input::Inking::InkStrokeBuilder : IInkStrokeBuilder, IInkStrokeBuilder2, IInkStrokeBuilder3
public sealed class InkStrokeBuilder : IInkStrokeBuilder, IInkStrokeBuilder2, IInkStrokeBuilder3
Public NotInheritable Class InkStrokeBuilder Implements IInkStrokeBuilder, IInkStrokeBuilder2, IInkStrokeBuilder3
var inkStrokeBuilder = new inkStrokeBuilder();
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

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

InkStrokeBuilder() InkStrokeBuilder() InkStrokeBuilder() InkStrokeBuilder() InkStrokeBuilder()

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 and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

Methods

AppendToStroke(PointerPoint) AppendToStroke(PointerPoint) AppendToStroke(PointerPoint) AppendToStroke(PointerPoint) AppendToStroke(PointerPoint)

Adds a new segment to the ink stroke.

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

Note

AppendToStroke is not supported by InkPresenter. Use CreateStrokeFromInkPoints and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

BeginStroke(PointerPoint) BeginStroke(PointerPoint) BeginStroke(PointerPoint) BeginStroke(PointerPoint) BeginStroke(PointerPoint)

Starts building the ink stroke.

Note

BeginStroke is not supported by InkPresenter. Use CreateStrokeFromInkPoints and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

CreateStroke(IIterable<Point>) CreateStroke(IIterable<Point>) CreateStroke(IIterable<Point>) CreateStroke(IIterable<Point>) CreateStroke(IIterable<Point>)

Creates a stroke from an array of Point coordinates.

Note

CreateStroke is not supported by InkPresenter. Use CreateStrokeFromInkPoints and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2)

Creates a basic ink stroke from collection of InkPoint objects.

Note

Use CreateStrokeFromInkPoints and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>) CreateStrokeFromInkPoints(IIterable<InkPoint>, Matrix3x2, IReference<DateTime>, IReference<TimeSpan>)

Creates a rich ink stroke from collection of InkPoint objects.

Note

Use CreateStrokeFromInkPoints and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

EndStroke(PointerPoint) EndStroke(PointerPoint) EndStroke(PointerPoint) EndStroke(PointerPoint) EndStroke(PointerPoint)

Stops building the ink stroke.

Note

EndStroke is not supported by InkPresenter. Use CreateStrokeFromInkPoints and SetDefaultDrawingAttributes to programmatically build strokes for an InkPresenter.

SetDefaultDrawingAttributes(InkDrawingAttributes) SetDefaultDrawingAttributes(InkDrawingAttributes) SetDefaultDrawingAttributes(InkDrawingAttributes) SetDefaultDrawingAttributes(InkDrawingAttributes) SetDefaultDrawingAttributes(InkDrawingAttributes)

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

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

Note

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

See Also