IInkAnalyzer::ModifyTopAlternateWithConfirmation method

Changes the current top alternate to the specified IAnalysisAlternate.

Syntax

HRESULT ModifyTopAlternateWithConfirmation(
  [in] IAnalysisAlternate *alternate,
  [in] VARIANT_BOOL       fconfirmAutomatically
);

Parameters

alternate [in]

The analysis alternate to set as the new top alternate.

fconfirmAutomatically [in]

VARIANT_TRUE to set all of the ink leaf context nodes that correspond to the analysis alternate to a confirmation type of ConfirmationType_NodeTypeAndProperties (see IContextNode::IsConfirmed and ConfirmationType); VARIANT_FALSE to set all of the ink leaf context nodes that correspond to the analysis alternate to a confirmation type of ConfirmationType_None.

Return value

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

Remarks

To get analysis alternates, use IInkAnalyzer::GetAlternates Method, IInkAnalyzer::GetAlternatesForContextNodes Method, or IInkAnalyzer::GetAlternatesForStrokes Method. To get the context node objects associated with an analysis alternate, use IAnalysisAlternate::GetAlternateNodes Method.

To change the confirmation type for a context node, use IContextNode::Confirm.

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

IContextNode

Ink Analysis ConfirmationType

Reference