IInkAnalyzer::UpdateStrokesData method

Updates the packet data for the specified strokes.

Syntax

HRESULT UpdateStrokesData(
  [in] ULONG ulStrokeIdsCount,
  [in] LONG  *plStrokeIds,
  [in] ULONG ulStrokePacketDescriptionCount,
  [in] GUID  *pStrokePacketDescriptionGuids,
  [in] ULONG *pulPacketDataCountPerStroke,
  [in] LONG  *plStrokePacketData
);

Parameters

ulStrokeIdsCount [in]

The number of strokes to update.

plStrokeIds [in]

An array containing the stroke identifiers.

ulStrokePacketDescriptionCount [in]

The number of properties in each packet.

pStrokePacketDescriptionGuids [in]

An array containing the packet property identifiers.

pulPacketDataCountPerStroke [in]

An array containing the number of packets in each stroke.

plStrokePacketData [in]

An array containing the packet data for the strokes.

Return value

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

Remarks

the plStrokePacketData parameter contains packet data for all of the strokes. The pStrokePacketDescriptionGuids parameter contains the globally unique identifiers (GUIDs) that describe the types of packet data included for each point in each stroke. For a complete list of available packet properties, see PacketPropertyGuids Constants.

Only strokes with the same packet descriptions can be updated in a single call to IInkAnalyzer::UpdateStrokesData Method.

This method does not update the ink analyzer's dirty region (see IInkAnalyzer::GetDirtyRegion Method).

If a specified stroke is not associated with the IInkAnalyzer, this method ignores the identifier.

If none of the specified strokes identify a stroke associated with the IInkAnalyzer, this method returns without updating the IInkAnalyzer.

This method returns an error code when plStrokeIds 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::AddStrokeToCustomRecognizer Method

IInkAnalyzer::AddStrokes Method

IInkAnalyzer::AddStrokesForLanguage Method

IInkAnalyzer::AddStrokesToCustomRecognizer Method

IInkAnalyzer::ClearStrokeData Method

_IAnalysisEvents::UpdateStrokesCache

Ink Analysis Reference