IInkAnalyzer::GetAlternatesForStrokes method

Retrieves analysis alternates for the strokes with the specified stroke identifiers.

Syntax

HRESULT GetAlternatesForStrokes(
  [in]  ULONG              ulStrokeIdsCount,
  [in]  LONG               *plStrokes,
  [in]  ULONG              ulMaximumAlternates,
  [out] AnalysisAlternates **ppAlternates
);

Parameters

ulStrokeIdsCount [in]

The number of stroke identifiers in plStrokes.

plStrokes [in]

The array of stroke identifiers.

ulMaximumAlternates [in]

The maximum number of analysis alternatives returned.

ppAlternates [out]

The IAnalysisAlternates object containing the analysis alternatives.

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 *ppAlternates when you no longer need to use the object.

The top IAnalysisAlternate is returned as the first alternate of the collection.

The specified strokes do not have to represent adjacent areas of the document.

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

IAnalysisAlternate

IAnalysisAlternates

IInkAnalyzer::GetAlternates Method

IInkAnalyzer::GetAlternatesForContextNodes Method

IInkAnalyzer::ModifyTopAlternate Method

IInkAnalyzer::ModifyTopAlternateWithConfirmation Method

Ink Analysis Reference