IInkStrokeContainer
IInkStrokeContainer
IInkStrokeContainer
IInkStrokeContainer
Interface
Definition
Represents a manager for the collection of InkStroke objects rendered by the InkPresenter.
Modifications made to any of the ink strokes in the stroke container are immediately rendered to the drawing surface associated with the InkPresenter.
public : interface IInkStrokeContainerpublic interface IInkStrokeContainerPublic Interface IInkStrokeContainer// You can use this interface in JavaScript.
- Attributes
| 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
For ink recognition, use an IInkRecognizerContainer object.
Properties
BoundingRect BoundingRect BoundingRect BoundingRect
Gets the bounding rectangle of the InkStroke collection managed by the InkStrokeContainer.
public : Rect BoundingRect { get; }public Rect BoundingRect { get; }Public ReadOnly Property BoundingRect As Rect// You can use this property in JavaScript.
- See Also
Methods
AddStroke(InkStroke) AddStroke(InkStroke) AddStroke(InkStroke) AddStroke(InkStroke)
Adds an InkStroke object to the collection managed by the InkStrokeContainer.
public : void AddStroke(InkStroke stroke)public void AddStroke(InkStroke stroke)Public Function AddStroke(stroke As InkStroke) As void// You can use this method in JavaScript.
The ink stroke to be added.
stroke must be created by using the Clone method, or through a call to EndStroke or ProcessPointerUp. Empty or existing strokes are not valid.
Remarks
The StrokesCollected event is fired when ink strokes are processed ("wet" to "dry") on the UI thread.
- See Also
CanPasteFromClipboard() CanPasteFromClipboard() CanPasteFromClipboard() CanPasteFromClipboard()
Identifies whether content on the clipboard can be added to the InkStroke collection managed by the InkStrokeContainer.
Note
Clipboard content must be in Ink Serialized Format (ISF).
public : PlatForm::Boolean CanPasteFromClipboard()public bool CanPasteFromClipboard()Public Function CanPasteFromClipboard() As bool// You can use this method in JavaScript.
True if content can be pasted from the clipboard; otherwise, false.
- See Also
CopySelectedToClipboard() CopySelectedToClipboard() CopySelectedToClipboard() CopySelectedToClipboard()
Copies the selected InkStroke objects (from the InkStroke collection managed by the InkStrokeContainer ) to the clipboard in Ink Serialized Format (ISF) format.
public : void CopySelectedToClipboard()public void CopySelectedToClipboard()Public Function CopySelectedToClipboard() As void// You can use this method in JavaScript.
- See Also
DeleteSelected() DeleteSelected() DeleteSelected() DeleteSelected()
Deletes the selected InkStroke objects from the InkStroke collection managed by the InkStrokeContainer.
public : Rect DeleteSelected()public Rect DeleteSelected()Public Function DeleteSelected() As Rect// You can use this method in JavaScript.
The bounding rectangle of the selected ink strokes, or the invalidated rectangle (0, 0, 0, 0) if no strokes were removed (no selected strokes).
Remarks
This method does not cause the StrokesErased event to fire.
- See Also
GetRecognitionResults() GetRecognitionResults() GetRecognitionResults() GetRecognitionResults()
Gets the collection of recognition matches previously processed by an InkRecognizer and stored in an InkRecognizerContainer.
Recognition is not supported by InkStrokeContainer, you must use an InkRecognizerContainer object.
public : IVectorView<InkRecognitionResult> GetRecognitionResults()public IReadOnlyList<InkRecognitionResult> GetRecognitionResults()Public Function GetRecognitionResults() As IReadOnlyList( Of InkRecognitionResult )// You can use this method in JavaScript.
The results of the recognition as a collection of InkRecognitionResult objects.
- See Also
GetStrokes() GetStrokes() GetStrokes() GetStrokes()
Retrieves all ink strokes in the collection managed by the InkStrokeContainer.
public : IVectorView<InkStroke> GetStrokes()public IReadOnlyList<InkStroke> GetStrokes()Public Function GetStrokes() As IReadOnlyList( Of InkStroke )// You can use this method in JavaScript.
The ink strokes managed by the InkStrokeContainer as a collection of InkStroke objects.
- See Also
LoadAsync(IInputStream) LoadAsync(IInputStream) LoadAsync(IInputStream) LoadAsync(IInputStream)
Asynchronously loads all InkStroke objects from the specified stream to the InkStroke collection that is managed by the InkStrokeContainer.
public : IAsyncActionWithProgress<ulong> LoadAsync(IInputStream inputStream)public IAsyncActionWithProgress<ulong> LoadAsync(IInputStream inputStream)Public Function LoadAsync(inputStream As IInputStream) As IAsyncActionWithProgress( Of ulong )// You can use this method in JavaScript.
- inputStream
- IInputStream IInputStream IInputStream IInputStream
The stream that contains the stroke collection. An IRandomAccessStream (requires IOutputStream ) object can be specified instead.
The status of the asynchronous operation as the number of bytes fetched. For more information, see ReadAsync method.
- See Also
MoveSelected(Point) MoveSelected(Point) MoveSelected(Point) MoveSelected(Point)
Moves the selected strokes. All affected strokes are re-rendered.
public : Rect MoveSelected(Point translation)public Rect MoveSelected(Point translation)Public Function MoveSelected(translation As Point) As Rect// You can use this method in JavaScript.
The destination screen coordinates for the upper-left corner of the bounding rectangle of the selected strokes.
Remarks
The following can result from a call to MoveSelected:
- Moving one or more strokes that make up part of a word results in the reprocessing of existing ink recognition results.
- Moving all strokes that make up a word results in the recalculation of the BoundingRect of the InkRecognitionResult. Ink recognition is not reprocessed.
- Moving one or more strokes results in the recalculation of the BoundingRect for each stroke.
- Moving one or more strokes results in the recalculation of the BoundingRect of the InkStrokeContainer.
- See Also
PasteFromClipboard(Point) PasteFromClipboard(Point) PasteFromClipboard(Point) PasteFromClipboard(Point)
Adds the InkStroke content from the clipboard to the InkStroke collection that is managed by the InkStrokeContainer and renders the new strokes.
public : Rect PasteFromClipboard(Point position)public Rect PasteFromClipboard(Point position)Public Function PasteFromClipboard(position As Point) As Rect// You can use this method in JavaScript.
The screen coordinates for the upper-left corner of the bounding rectangle of the clipboard content.
Remarks
The content of the clipboard must be in Ink Serialized Format (ISF) format.
- See Also
SaveAsync(IOutputStream) SaveAsync(IOutputStream) SaveAsync(IOutputStream) SaveAsync(IOutputStream)
Asynchronously saves all InkStroke objects in the InkStroke collection that is managed by the InkStrokeContainer to the specified stream.
public : IAsyncOperationWithProgress<unsigned int, unsigned int> SaveAsync(IOutputStream outputStream)public IAsyncOperationWithProgress<uint, uint> SaveAsync(IOutputStream outputStream)Public Function SaveAsync(outputStream As IOutputStream) As IAsyncOperationWithProgress( Of uint, uint )// You can use this method in JavaScript.
- outputStream
- IOutputStream IOutputStream IOutputStream IOutputStream
The target stream. An IRandomAccessStream (requires IOutputStream ) object can be specified instead.
The size of the saved stream and the status of the asynchronous operation as the number of bytes sent. For more information, see WriteAsync method.
- See Also
SelectWithLine(Point, Point) SelectWithLine(Point, Point) SelectWithLine(Point, Point) SelectWithLine(Point, Point)
Selects all strokes intersected by the new stroke.
Note
The Selected flag is reset for all other strokes in the collection.
public : Rect SelectWithLine(Point from, Point to)public Rect SelectWithLine(Point from, Point to)Public Function SelectWithLine(from As Point, to As Point) As Rect// You can use this method in JavaScript.
- See Also
SelectWithPolyLine(IIterable)
SelectWithPolyLine(IIterable)
SelectWithPolyLine(IIterable)
SelectWithPolyLine(IIterable)
Selects all strokes contained entirely within the polyline.
Note
The Selected flag is reset for all other strokes in the collection.
.
public : Rect SelectWithPolyLine(IIterable<Point> polyline)public Rect SelectWithPolyLine(IEnumerable<Point> polyline)Public Function SelectWithPolyLine(polyline As IEnumerable<Point>) As Rect// You can use this method in JavaScript.
- polyline
- IIterable<Point> IEnumerable<Point> IEnumerable<Point> IEnumerable<Point>
The points of the polyline.
- See Also
UpdateRecognitionResults(IVectorView)
UpdateRecognitionResults(IVectorView)
UpdateRecognitionResults(IVectorView)
UpdateRecognitionResults(IVectorView)
Updates the collection of recognition matches previously processed by an InkRecognizer and stored in an InkRecognizerContainer.
Recognition is not supported by InkStrokeContainer, you must use an InkRecognizerContainer object.
public : void UpdateRecognitionResults(IVectorView<InkRecognitionResult> recognitionResults)public void UpdateRecognitionResults(IReadOnlyList<InkRecognitionResult> recognitionResults)Public Function UpdateRecognitionResults(recognitionResults As IReadOnlyList<InkRecognitionResult>) As void// You can use this method in JavaScript.
- recognitionResults
- IVectorView<InkRecognitionResult> IReadOnlyList<InkRecognitionResult> IReadOnlyList<InkRecognitionResult> IReadOnlyList<InkRecognitionResult>
The updated collection of InkRecognitionResult objects.
- See Also