InkDivider class

Represents the ability to analyze the layout of a collection of strokes and divide them into text and graphics.

InkDivider has these types of members:

Interfaces

The InkDivider class defines these interfaces.

InterfaceDescription
IInkDivider

This object implements the IInkDivider COM interface.

 

Methods

The InkDivider class has these methods.

MethodDescription
Divide

Returns an IInkDivisionResult object that contains structural information about the strokes in the InkDivider object.

 

Properties

The InkDivider class has these properties.

PropertyAccess typeDescription

LineHeight

Read/write

Gets or sets the expected handwriting height in HIMETRIC units.

RecognizerContext

Read/write

Gets or sets the InkRecognizerContext object used for handwriting recognition.

Strokes

Read/write

Gets or sets the InkStrokes collection contained by the InkDivider object.

 

Remarks

This object can be instantiated by calling the CoCreateInstance method in C++.

The InkDivider object uses the layout of the strokes, the order in which the strokes are added, the direction in which the strokes are drawn, and other factors to perform the analysis of the ink. The InkStrokes collection that the InkDivider object analyzes is contained in the Strokes property of the InkDivider object. The InkDivider object dynamically analyzes the InkStrokes collection as you add to or delete from the collection, but it performs no modification of the strokes.

The analysis results are returned in an IInkDivisionResult object.

The InkDivider object uses an InkRecognizerContext object to more accurately divide the strokes and to assign a recognition string to the results.

Note  The InkDivider object uses the default property settings of the InkRecognizerContext object.
 

If you do not assign a recognizer context to the InkDivider object, the InkDivider object still analyzes the ink, but it divides the strokes less accurately and does not associate text with the division results.

Note  The RecognizerContext property should be set before adding strokes to the Strokes property. After strokes have been added to the InkDivider object, the RecognizerContext property cannot be changed.
 

The InkDivider does not currently support vertical languages. For the InkDivider object to recognize these languages properly the IInkRecognizer object for the language must support the free input capability and the characters must be written from left to right.

Requirements

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

Header

Msinkaut15.h (also requires Msinkaut15_i.c)

Library

Inkdiv.dll

See also

IInkDivisionResult Interface
InkRecognizerContext Class
InkStrokes Collection

 

 

Show: