IInkRecognitionResult interface (msinkaut.h)
Represents the result of the recognition. The results of recognizing handwritten ink are returned in an IInkRecognitionResult object.
Inheritance
The IInkRecognitionResult interface inherits from the IUnknown interface. IInkRecognitionResult also has these types of members:
Methods
The IInkRecognitionResult interface has these methods.
| IInkRecognitionResult::get_Strokes Gets the collection of strokes that are contained in an object or used to create an object. (IInkRecognitionResult.get_Strokes) |
| IInkRecognitionResult::get_TopAlternate Gets the top alternate of the recognition result. (IInkRecognitionResult.get_TopAlternate) |
| IInkRecognitionResult::get_TopConfidence Gets the top alternate of the recognition result. (IInkRecognitionResult.get_TopConfidence) |
| IInkRecognitionResult::get_TopString Gets the result text for the TopAlternate property. |
| IInkRecognitionResult::ModifyTopAlternate Changes the top alternate of a recognition result by using the specified alternate. |
| IInkRecognitionResult::SetResultOnStrokes Assigns the recognition results to the strokes that were used to create the results. |
Remarks
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 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 CustomStrokes collection on the InkDisp object.
Not all recognizers set the TopConfidence property. When an application attempts to access a property that is not set by the recognizer, an argument exception is thrown.
If you define a class that implements this interface, the new class will not interact correctly with the Tablet PC application programming interfaces (APIs).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP Tablet PC Edition [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | msinkaut.h |