IInkAnalyzer::Reconcile method

Applies to: desktop apps only

Applies the results of a background ink analysis operation to the context node tree for the portions of the tree that have not been modified by the application since the call to IInkAnalyzer::BackgroundAnalyze Method.

Syntax

HRESULT Reconcile();

Parameters

This method has no parameters.

Return value

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

Remarks

By default, the IInkAnalyzer performs an automatic reconciliation phase immediately before raising the _IAnalysisEvents::IntermediateResults and _IAnalysisEvents::Results events.

To disable automatic reconciliation, clear the AnalysisModes_AutomaticReconciliation flag from the ink analyzer's analysis modes (see IInkAnalyzer::SetAnalysisModes Method and AnalysisModes). The IInkAnalyzer::BackgroundAnalyze Method method returns an error when automatic reconciliation is disabled and your application does not handle the _IAnalysisEvents::ReadyToReconcile event. Your application must call the IInkAnalyzer::Reconcile Method method before the IInkAnalyzer can continue to process the results or continue further analysis for the corresponding analysis stage.

Your application can make changes, such as adding or removing strokes and changing stroke data, in the IInkAnalyzer object's context node tree during background analysis. Such changes can invalidate portions of the background analysis results. This method applies analysis results only to the analyzer's context node tree for the portions of the tree that your application has not changed. This method also adds regions containing invalidated analysis results to the IInkAnalyzer object's dirty region (see IInkAnalyzer::GetDirtyRegion Method).

For more information about using the to analyze ink, see Ink Analysis Overview.AnalysisModes

Requirements

See also

IInkAnalyzer

IInkAnalyzer::BackgroundAnalyze Method

_IAnalysisEvents::ReadyToReconcile

Ink Analysis Reference

Send comments about this topic to Microsoft

Build date: 3/6/2012