IInkRecognitionResult::TopAlternate
4/8/2010
Gets the top alternate of the IInkRecognitionResult.
Syntax
[propget] HRESULT get_TopAlternate([out,retval]IInkRecognitionAlternate **TopAlternate
);
Parameters
TopAlternate
The top alternate of the recognition result.This property is read-only.
Return Value
| HRESULT value | Description |
|---|---|
S_OK |
Success. |
E_POINTER |
The TopAlternate parameter is an invalid pointer. |
E_OUTOFMEMORY |
Cannot allocate memory to complete the operation. |
E_INK_EXCEPTION |
An exception occurred while processing. |
E_UNEXPECTED |
Unexpected object property type. |
Remarks
When the recognizer returns a recognition result, the recognition alternates are ranked from the highest confidence level to the lowest confidence level. The recognition alternate with the highest confidence level is selected as the top alternate.
You can use the IInkRecognitionResult::ModifyTopAlternate method to change which recognition alternate is the top alternate.
Requirements
| Header | msinkaut.h |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later |