IInkAnalyzer::FindNodesWithCallBackInSubTree method

Retrieves all of the IContextNode objects that match the specified criteria and are descendants of the specified IContextNode object.


HRESULT FindNodesWithCallBackInSubTree(
  [in]  IMatchesCriteriaCallBack *pCriteria,
  [in]  IContextNode             *pContextNodeToSearchFrom,
  [out] IContextNodes            **ppContextNodesFound


pCriteria [in]

An IMatchesCriteriaCallBack object that is used to evaluate whether an IContextNode object meets or fails its specified criteria.

pContextNodeToSearchFrom [in]

The IContextNode object whose descendants are searched.

ppContextNodesFound [out]

A pointer to the IContextNodes containing all nodes that meet the specified criteria.

Return value

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


To avoid a memory leak, call IUnknown::Release on ppContextNodesFound when you no longer need to use the object.

If the IInkAnalyzer does not contain the pContextNodeToSearchFrom node, this method returns an error code.

If the IInkAnalyzer contains no such IContextNode, an empty IContextNodes collection is returned.


Minimum supported client
Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
None supported
IACom.h (also requires IACom_i.c)

See also


IInkAnalyzer::FindInkLeafNodes Method

IInkAnalyzer::FindInkLeafNodesForStrokes Method

IInkAnalyzer::FindLeafNodes Method

IInkAnalyzer::FindNode Method

IInkAnalyzer::FindNodesOfType Method

IInkAnalyzer::FindNodesOfTypeForStrokes Method

IInkAnalyzer::FindNodesOfTypeInSubTree Method

IInkAnalyzer::FindNodesWithCallBack Method

Ink Analysis Reference