Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

4/8/2010

The results of recognizing handwritten ink are returned in an IInkRecognitionResultobject.

IInkRecognitionAlternateobjects, 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 IInkRecognitionResultobject 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::SetResultOnStrokesmethod to assign results to a collection of strokes.

The only way to persist recognition results is to call SetResultOnStrokesand then add this collection of strokes to the IInkCustomStrokescollection on the IInkDispobject.

Not all recognizers set the IInkRecognitionResult::TopConfidenceproperty. 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.

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 IInkRecognitionResultobject.

IInkRecognitionResult Properties: Provides a description of the properties for the IInkRecognitionResultobject.

In This Section

See Also

Concepts