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)

Applies To