IInkRecognizerContext
4/8/2010
Enables the ability to perform ink recognition, retrieve the recognition result, and retrieve alternates. The InkRecognizerContext enables the various recognizers that are installed on a system to use ink recognition to process input appropriately.
Ink is processed continuously in the background. If an IInkStrokeDisp is added to the IInkStrokes collection to which the InkRecognizerContext refers, then the IInkStrokeDisp is then recognized immediately.
All recognition occurs through a recognizer context. The context defines the settings for a single recognition session. It receives the ink that must be recognized and defines the constraints on the ink input and on the recognition output. The constraints that can be set on the context include the language, the dictionary, and grammar that is being used.
Setting properties other than the IInkRecognizerContext::Strokes or property succeeds only if the IInkStrokes collection is NULL. You must set the other properties before you attach the IInkStrokes collection to the InkRecognizerContext, or you must set the IInkStrokes collection to NULL and then set the other properties. If you set the IInkStrokes collection to NULL and then set the other properties, you may have to reattach the IInkStrokes collection. This is because the recognition starts right after you assign the IInkStrokes to the InkRecognizerContext.
To improve your application's performance, dispose of your InkRecognizerContext object when it is no longer needed.
In This Section
- IInkRecognizerContext Methods
Describes the methods available for the InkRecognizerContext.
- IInkRecognizerContext Properties
Describes the properties available for the InkRecognizerContext.