IInkAnalyzer::RemoveStrokes method

Article
01/07/2021

Removes the specified strokes from the IInkAnalyzer.

Syntax

HRESULT RemoveStrokes(
  [in] ULONG ulStrokeIdCount,
  [in] LONG  *plStrokes
);

Parameters

ulStrokeIdCount [in]: The number of stroke identifiers in plStrokes.
plStrokes [in]: The identifiers for the strokes to remove.

Return value

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

Remarks

This method removes the packet data for and references to the specified strokes from the IInkAnalyzer.

This method removes the strokes from the leaf context node that references the strokes. If any IContextNode no longer references any strokes, this method deletes the IContextNode and any ancestor IContextNode objects that no longer have any child nodes.

After this method removes the strokes from the IContextNode, it updates the IInkAnalyzer object's dirty region (see IInkAnalyzer::GetDirtyRegion Method) to include the bounding box of the removed strokes.

If a stroke identified in plStrokes is not associated with the IInkAnalyzer, this method ignores the identifier.

If none of the strokes identified in plStrokes are associated with the ink analyzer, this method returns without updating the IInkAnalyzer.

This method returns and error code when plStrokes is null.

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