IInkRecognitionAlternate::Confidence
4/8/2010
Gets the level of confidence (strong, intermediate, or poor) that a recognizer has in the recognition of an IInkRecognitionAlternate object.
Syntax
[propget] HRESULT get_Confidence ([out, retval] InkRecognitionConfidence * Confidence
);
Parameters
Confidence
The level of confidence that a recognizer has in the recognition of an alternate.This property is read–only.
Return Value
| HRESULT value | Description |
|---|---|
S_OK |
Success. |
E_POINTER |
The parameter is an invalid pointer. |
E_INK_EXCEPTION |
An exception occurred while processing. |
E_NOTIMPL |
Confidence evaluation is not available with the selected recognizer. |
Remarks
For a list of confidence values that may be returned, see the InkRecognitionConfidence enumeration type.
If the alternate represents a phrase or sentence, the value represents the lowest confidence level of a recognition segment found in the phrase or sentence. However, if the alternate represents a word, the value represents the confidence level of the word.
Note
This property throws an exception if the IInkRecognizer that generates the IInkRecognitionAlternate does not support confidence levels.
Of the Microsoft recognizers, only the Microsoft English (US) Handwriting Recognizer and the Microsoft Gesture Recognizer support confidence levels. Third party recognizers may or may not support confidence levels.
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 |