_IAnalysisProxyEvents::InkAnalyzerStateChanging event

Occurs before the IInkAnalyzer reconciles analysis results so that an application can synchronize data with the IInkAnalyzer.

Syntax

HRESULT InkAnalyzerStateChanging(
  [in] IInkAnalyzer *pInkAnalyzer
);

Parameters

pInkAnalyzer [in]

The IInkAnalyzer that is about to reconcile its analysis results.

Return value

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

Remarks

Use this event when your application maintains its own data structure, which is synchronized with that of the IInkAnalyzer. When the IInkAnalyzer raises this event, your application should populate the subnodes of the ink analyzer's root node (see IContextNode::GetSubNodes and IInkAnalyzer::GetRootNode Method).

The IInkAnalyzer raises this event after it raises the _IAnalysisEvents::ReadyToReconcile event. It raises this event only while performing background analysis.

Lock your data structure when the IInkAnalyzer raises the _IAnalysisProxyEvents::InkAnalyzerStateChanging event. Changes to your data structure during this phase of analysis can cause errors in ink analysis and synchronization. Unlock your data structure when the IInkAnalyzer raises the _IAnalysisEvents::IntermediateResults or _IAnalysisEvents::Results event.

For more information about synchronizing your application data with the IInkAnalyzer, see Data Proxy with Ink 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

_IAnalysisProxyEvents

IInkAnalyzer

IContextNode

IInkAnalyzer::Analyze Method

IInkAnalyzer::BackgroundAnalyze Method

Ink Analysis Reference