IInkAnalyzer::GetInkAnalysisRecognizersByPriority method

Retrieves an ordered collection of IInkAnalysisRecognizer objects.

Syntax

HRESULT GetInkAnalysisRecognizersByPriority(
  [out] IInkAnalysisRecognizers **ppInkAnalysisRecognizers
);

Parameters

ppInkAnalysisRecognizers [out]

An ordered collection of IInkAnalysisRecognizer objects.

Return value

For a description of the return values, see Classes and Interfaces - Ink Analysis.

Remarks

Caution

To avoid a memory leak, call IUnknown::Release on ppInkAnalysisRecognizers when you no longer need to use the object.

The order of the recognizers in this collection indicates the order in which the IInkAnalyzer evaluates the available recognizers. The IInkAnalyzer uses the language of the strokes as its primary criterion for applying an IInkAnalysisRecognizer. As a secondary criterion, the IInkAnalyzer compares analysis hint information against an IInkAnalysisRecognizer object's supported capabilities (see IInkAnalysisRecognizer::GetCapabilities). For more information about analysis hints, see IInkAnalyzer::CreateAnalysisHint Method.

If more than one IInkAnalysisRecognizer supports a language identifier, the IInkAnalyzer uses a "first-fit" algorithm to select the first IInkAnalysisRecognizer to analyze strokes of that language.

Requirements

Requirement Value
Minimum supported client
Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
None supported
Header
IACom.h (also requires IACom_i.c)
DLL
IACom.dll

See also

IInkAnalyzer

IInkAnalysisRecognizers

IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer Method

Ink Analysis Reference