_IAnalysisProxyEvents::PopulateContextNode event
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 |
|
| DLL |
|