IInkAnalyzer::RemoveStrokes method

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

See also

IInkAnalyzer

IInkAnalyzer::AddStroke Method

IInkAnalyzer::AddStrokeForLanguage Method

IInkAnalyzer::AddStrokes Method

IInkAnalyzer::AddStrokesForLanguage Method

IInkAnalyzer::RemoveStroke Method

IInkAnalyzer::GetDirtyRegion Method

Ink Analysis Reference