_IAnalysisProxyEvents::ContextNodeCreated event

Article
03/05/2021

Occurs after the IInkAnalyzer creates an IContextNode object.

Syntax

HRESULT ContextNodeCreated(
  [in] IInkAnalyzer *pInkAnalyzer,
  [in] IContextNode *pContextNodeCreated
);

Parameters

pInkAnalyzer [in]: The IInkAnalyzer creating the IContextNode object.
pContextNodeCreated [in]: The new 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. This event occurs during the reconcile phase of ink analysis, or in response to an ink analyzer method that creates an IContextNode.

When the IInkAnalyzer creates an IContextNode, the new IContextNode does not contain any strokes, does not contain links to other IContextNode objects, and may not have all of its properties set. Also, the new IContextNode is added to the end of its parent node's collection of subnodes (see IContextNode::GetParentNode and IContextNode::GetSubNodes). After this event, the IInkAnalyzer may raise the following events.

The _IAnalysisProxyEvents::StrokeReparented event when it moves a stroke from one context node to another.
The _IAnalysisProxyEvents::ContextNodeLinkAdding event when it adds an IContextLink to an IContextNode.
The _IAnalysisProxyEvents::ContextNodeMovingToPosition event when it changes the order of an IContextNode within its parent node's collection of subnodes.
The IInkAnalyzer raises the _IAnalysisProxyEvents::ContextNodePropertiesUpdated event after it resolves the state of the IContextNode for this analysis phase.

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