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

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::ModifyTopAlternatemethod 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

See Also