Working with the Divider Object

Description of how to work with the divider object.

The Divider object provides access to the Tablet PC layout analysis features.

In managed code, the Divider object can be instantiated by calling one of the Divider constructors. In Automation, this is called the InkDivider object, and it can be instantiated by calling the CoCreateInstance method in C++ or by using the New keyword in Microsoft® Visual Basic® 6.0.

You can obtain a snapshot of the current analysis result by calling the Divide method of the Divider object. The analysis result is returned in a DivisionResult object. Each time you call the Divide method, the Divider object creates a DivisionResult object. For more information about the DivisionResult object, see Working with the DivisionResult Object.

The Strokes collection that the Divider object analyzes is contained in the Strokes property of the Divider object. The Divider object dynamically analyzes the Strokes collection as you add to or delete from the collection. For more information about the Strokes property of the Divider object, see Working with a Strokes Collection.

The Divider object uses a recognizer context to improve its analysis of recognition segments and to generate recognition text for handwriting elements. You can set the recognizer context by using the RecognizerContext property of the Divider object. The RecognizerContext property cannot be changed after strokes have been assigned to the Divider object. For more information about the RecognizerContext property of the Divider object, see Working with a Recognizer Context.

Caution: In managed code, you must call the Dispose method on this object before it goes out of scope. This object maintains non-managed resources. Relying on finalization for this object can cause memory leaks and exceptions within your application.