_IAnalysisProxyEvents::PopulateContextNode event

Article
03/05/2021

Occurs before the IInkAnalyzer performs analysis within the region of a partially populated IContextNode object.

Syntax

HRESULT PopulateContextNode(
  [in] IInkAnalyzer *pInkAnalyzer,
  [in] IContextNode *pContextNodeToPopulate
);

Parameters

pInkAnalyzer [in]: The IInkAnalyzer object about to perform analysis.
pContextNodeToPopulate [in]: The partially populated IContextNode object.

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 pContextNodeToPopulate. During the analysis phase, the IInkAnalyzer raises this event to get information for areas in which it is analyzing ink.

If the document contains links for the pContextNodeToPopulate, your application should create and add these links. This process requires that both the source and destination nodes, including their ancestors, are fully populated before the event handler for this event exits (see IContextLink::GetSourceNode and IContextLink::GetDestinationNode).

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

During background analysis, the IInkAnalyzer raises this event after it raises the _IAnalysisEvents::ReadyToReconcile event.

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