IInkRecognitionResult
4/8/2010
The results of recognizing handwritten ink are returned in an IInkRecognitionResult object.
IInkRecognitionAlternate objects, or alternates, are created from the result. The best, or top, alternate is the one that is used by the default in the result. However, you can use the methods of the IInkRecognitionResult object to specify which alternates to use in the result.
System performance can suffer if recognition results are automatically assigned to every collection of stroke. Therefore, by default, results are not attached to a collection of strokes. You must call the IInkRecognitionResult::SetResultOnStrokes method to assign results to a collection of strokes.
The only way to persist recognition results is to call SetResultOnStrokes and then add this collection of strokes to the IInkCustomStrokes collection on the IInkDisp object.
Not all recognizers set the IInkRecognitionResult::TopConfidence property. When an application attempts to access a property that is not set by the recognizer, an argument exception is thrown.
Note
The various handwriting recognizers shipped from Microsoft® in both Latin script and East Asian languages can sometimes produce the Unicode value 0xFFFF as the recognition result. This occurs when the recognizer is unable to match a piece of ink with any valid character. The 0xFFFF code point is valid UCS-2, but not allowed in UTF-8. An application that converts recognition results to UTF-8, should replace 0xFFFF with some other code point, for example, 0xFFFD.
In This Section
- IInkRecognitionResult Methods
Provides a description of the methods for the IInkRecognitionResult object.
- IInkRecognitionResult Properties
Provides a description of the properties for the IInkRecognitionResult object.