Strokes Property [InkDivider Class]
Strokes Property [InkDivider Class] |
Gets or sets the InkStrokes collection on which the InkDivider object performs layout analysis.
Declaration
[C++]
[C++]
[propputref] HRESULT putref_Strokes([in] IInkStrokes* theStrokes);
[propget] HRESULT get_Strokes([out,retval] IInkStrokes** theStrokes);
[Microsoft® Visual Basic® 6.0]
[Visual Basic]
Public Property Get Strokes() As InkStrokes
Public Property Let Strokes(ByRef theStrokes As InkStrokes)
Return Value
This property gets or sets the InkStrokes collection that is associated with the InkDivider object.
HRESULT value | Description |
---|---|
S_OK | Success. |
E_POINTER | A parameter contains an invalid pointer. |
E_OUTOFMEMORY | Unable to allocate memory to complete the operation. |
E_UNEXPECTED | Unexpected parameter or property type. |
E_INK_EXCEPTION | An exception occurred inside the method. |
Remarks
This property maintains the InkStrokes collection which the InkDivider object analyzes and from which the InkDivider object creates the IInkDivisionResult object. This property must be assigned a InkStrokes collection in order for the InkDivider object to perform layout analysis.
Note: You may not change the LineHeight or RecognizerContext property after a InkStrokes collection is assigned to the Strokes property.
To keep the Strokes property of the InkDivider object synchronized with an InkDisp object, use the InkAdded and InkDeleted events of the InkDisp object to listen for strokes that should be added or removed from the InkDivider object. This covers cases where strokes are added to, deleted from, clipped, or split within the InkDisp object.
Note: Moving, scaling, or other transformations on strokes in the InkDisp object do not generate InkAdded or InkDeleted events. Perform the same transformations on the strokes in the InkDivider object to keep the Strokes property of the InkDivider object synchronized.
Example
[Visual Basic 6.0]
This Visual Basic 6.0 example adds a IInkStrokeDisp object theStroke to an existing strokes collection associated with an InkDivider object theInkDivider.
[Visual Basic]
theInkDivider.Strokes.Add(theStroke)