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 |
|
| DLL |
|