IInkAnalyzer::FindNodesOfTypeForStrokes method

Retrieves all of the IContextNode objects of the specified type that contain the specified strokes.

Syntax

HRESULT FindNodesOfTypeForStrokes(
  [in]  const GUID          *pNodeType,
  [in]        ULONG         ulStrokeIdsCount,
  [in]        LONG          *plStrokeIds,
  [out]       IContextNodes **ppContextNodesFound
);

Parameters

pNodeType [in]

The globally unique identifier (GUID) that specifies the node type.

ulStrokeIdsCount [in]

The number of stroke identifiers passed in.

plStrokeIds [in]

An array of the stroke identifiers.

ppContextNodesFound [out]

The collection of IContextNode objects that contain all the nodes of type pNodeType that contain the strokes with identifiers in the plStrokeIds array.

Return value

For a description of 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.

The pNodeType property must contain a GUID from the Context Node Types constants.

If the specified node type is not a leaf node, but one of the node's descendants references a stroke in the strokes collection, that node is added to the collection that is returned.

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::FindNodesOfTypeInSubTree Method

IInkAnalyzer::FindNodesWithCallBack Method

IInkAnalyzer::FindNodesWithCallBackInSubTree Method

Ink Analysis Reference