InkAnalyzerBase.SaveResults Method (Hashtable, ContextNodeBaseCollection)

Article
10/19/2012

Saves analysis results for a specific context node collection associated with an ink analyzer.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

'Declaration
Public Function SaveResults ( _
    strokeIdMap As Hashtable, _
    nodes As ContextNodeBaseCollection _
) As Byte()
'Usage
Dim instance As InkAnalyzerBase 
Dim strokeIdMap As Hashtable 
Dim nodes As ContextNodeBaseCollection 
Dim returnValue As Byte()

returnValue = instance.SaveResults(strokeIdMap, _
    nodes)

public byte[] SaveResults(
    Hashtable strokeIdMap,
    ContextNodeBaseCollection nodes
)

public:
array<unsigned char>^ SaveResults(
    Hashtable^ strokeIdMap, 
    ContextNodeBaseCollection^ nodes
)

public function SaveResults(
    strokeIdMap : Hashtable, 
    nodes : ContextNodeBaseCollection
) : byte[]

Parameters

strokeIdMap
Type: System.Collections.Hashtable

Map between the stroke identifiers used by the InkAnalyzer and the stroke identifiers used for saving. See Remarks.

nodes
Type: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection

The context node collection for which to save analysis results.

Return Value

Type: array<System.Byte[]
Returns the saved InkAnalyzer results. This data, along with the relevant ink data, can be persisted to a storage medium. The returned value does not contain any ink data, but contains only the persisted results of the InkAnalyzer.

Remarks

If you are using the baser layer APIs, you will have to manage your own stroke IDs. You may wish to use an Ink object to save the relevant data. In this scenario, add all the strokes to a new Ink object and call the Save method. You will need some way to let Ink Analysis know about the changed IDs for the same strokes. The strokeIdMap is used for that purpose.

This method saves the current analysis results for nodes and for all of their ancestor and descendant context nodes.

This method throws an exception when any context node in nodes has a PartiallyPopulated value of true.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via