IInkAnalyzer::FindNodesWithCallBackInSubTree method

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

Syntax

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

Parameters

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.

Remarks

Caution

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.

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

IInkAnalyzer

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