_IAnalysisEvents::ReadyToReconcile event

Occurs when the IInkAnalyzer is ready to reconcile its background analysis results with its current state.

Syntax

HRESULT ReadyToReconcile();

Parameters

This event has no parameters.

Return value

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

Remarks

The IInkAnalyzer performs automatic reconciliation when the ink analyzer's AnalysisModes_AutomaticReconciliation flag is set (see IInkAnalyzer::SetAnalysisModes Method). When the AnalysisModes_AutomaticReconciliation flag is not set, your application needs to reconcile background analysis results manually.

To perform manual reconciliation, follow these steps.

  1. Clear the ink analyzer's AnalysisModes_AutomaticReconciliation flag.
  2. Handle the _IAnalysisEvents::ReadyToReconcile event.
  3. To reconcile the analysis results, call the IInkAnalyzer::Reconcile Method method from the event handler for the _IAnalysisEvents::ReadyToReconcile event. To cancel the current background analysis operation, call the IInkAnalyzer::Abort Method method from the event handler for the _IAnalysisEvents::ReadyToReconcile event.

The IInkAnalyzer raises this event before it raises the _IAnalysisProxyEvents::InkAnalyzerStateChanging event.

For more information about synchronizing your application data with the IInkAnalyzer, see Data Proxy with Ink Analysis.

The IInkAnalyzer raises this event during background analysis.

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

_IAnalysisEvents

AnalysisModes

_IAnalysisProxyEvents

IInkAnalyzer

IInkAnalyzer::Analyze Method

IInkAnalyzer::BackgroundAnalyze Method

IInkAnalyzer::Reconcile Method

Ink Analysis Reference