Divide Method

Divide Method

Returns a IInkDivisionResult object that contains the results of the layout analysis of strokes in the InkDivider object.

Declaration

[C++]

HRESULT Divide(
    [out,retval] IInkDivisionResult** InkDivisionResult
);

[Microsoft® Visual Basic® 6.0]

Public Function Divide() As InkDivisionResult

Parameters

InkDivisionResult

[out,retval] Returns a IInkDivisionResult object that contains structural information about the strokes in the InkDivider object.

Return Value

HRESULT value Description
S_OK Success.
E_POINTER A parameter contains an invalid pointer.
E_UNEXPECTED Unexpected parameter or property type.
E_FAIL An unspecified error occurred.
E_OUTOFMEMORY Unable to allocate memory to complete the operation.
E_INK_EXCEPTION An exception occurred inside the method.

Remarks

This method returns a new IInkDivisionResult object each time this method is called.

Example

[Visual Basic 6.0]

This Visual Basic 6.0 example creates an InkDivider, theDivider, and assigns to it a InkStrokes collection, theStrokes, and a InkRecognizerContext object, theRecognizerContext. The Divide method is called to get a snapshot of the analysis results, theResult. The ResultByType method is called with an InkDivisionType enumeration value of IDT_Line to retrieve all of the line units within theResult. If the collection of lines is not empty, then for each line, theLine, in the collection, the DivisionType, Strokes, RecognitionString, and RotationTransform properties are retrieved.

        ' Create the InkDivider and assign a strokes collection to it.
Dim theDivider As InkDivider
Set theDivider = New InkDivider
Set theDivider.ReconizerContext = theRecognizerContext
Set theDivider.Strokes = theStrokes

' Retrieve the analysis results, and get the first line.
Dim theResult As IInkDivisionResult
Set theResult = theDivider.Divide()
Dim theDivisionUnits As IInkDivisionUnits
Set theDivisionUnits = theResult.ResultByType(InkDivisionType.IDT_Line)
Dim theLine As IInkDivisionUnit
If Not (theDivisionUnits Is Nothing) Then
    For Each theLine In theDivisionUnits
        ' For each line element in the collection
        ' retrieve the division type, the strokes,
        ' the recognition string, and the rotation transform.
        Dim theDivisionType As InkDivisionType
        theDivisionType = theLine.DivisionType
        Dim elementStrokes As InkStrokes
        Set elementStrokes = theLine.Strokes
        Dim theRecognitionString As String
        theRecognitionString = theLine.RecognizedString
        Dim theInkTransform As InkTransform
        theInkTransform = theLine.RotationTransform
    Next
End If

Applies To