IInkAnalyzer::Reconcile method
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
Requirement | Value |
---|---|
Minimum supported client |
Windows XP Tablet PC Edition [desktop apps only] |
Minimum supported server |
None supported |
Header |
|
DLL |
|