InkAnalyzer.Load Method (array<Byte[])
Loads saved analysis results into the ink analyzer. Also loads the ink data to the associated Microsoft.Ink.Ink object.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Syntax
'Declaration
Public Function Load ( _
serializedResults As Byte() _
) As Boolean
'Usage
Dim instance As InkAnalyzer
Dim serializedResults As Byte()
Dim returnValue As Boolean
returnValue = instance.Load(serializedResults)
public bool Load(
byte[] serializedResults
)
public:
bool Load(
array<unsigned char>^ serializedResults
)
public function Load(
serializedResults : byte[]
) : boolean
Parameters
serializedResults
Type: array<System.Byte[]An 8-bit unsigned integer array that contains the saved analysis results.
Return Value
Type: System.Boolean
true if the analysis results loaded successfully; otherwise, false.
Remarks
If ink data is included in the analysis results, the InkAnalyzer adds the saved strokes to the Microsoft.Ink.Ink object associated with the ink analyzer.
When the InkAnalyzer adds a ContextNode from the saved results, it assigns a new globally unique identifier (GUID) to the ContextNode object's Id property.
This method appends the saved analysis results to existing results. To ensure that the combined results are ordered correctly, add the area containing the loaded context nodes to the ink analyzer's DirtyRegion and reanalyze the ink.
If the InkAnalyzer adds the saved strokes to the associated Microsoft.Ink.Ink object, the loaded analysis results reference the loaded strokes in the associated ink.
If the analyzer does not add the saved strokes to the associated Microsoft.Ink.Ink object, the analyzer compares the stroke identifiers in the saved results with the stroke identifiers in the existing Microsoft.Ink.Ink object to associate the loaded analysis results with the existing strokes.
If a saved analysis hint conflicts with an existing analysis hint, the ink analyzer does not load the saved hint but does load the rest of the saved results. However, if saved stroke data is within the area of a saved analysis hint that is not loaded, the analyzer adds the bounding box of the stroke to the analyzer's DirtyRegion. Also, if saved stroke data is within an existing analysis hint's area, the analyzer also adds the bounding box of the stroke to the analyzer's DirtyRegion. For more information about analysis hints, see AnalysisHintNode.
The InkAnalyzer raises the ContextNodeCreated, ContextNodeLinkAdding, and ContextNodePropertiesUpdated events as it loads the saved results.
Examples
This example loads saved analysis results from an 8-bit unsigned integer array, theSavedResults, into the InkAnalyzer, theInkAnalyzer. At the same time, it loads saved ink data to the analyzer's associated Microsoft.Ink.Ink object.
' Load previously saved analysis results and associated ink data.
successful = Me.theInkAnalyzer.Load(theSavedResults)
// Load previously saved analysis results and associated ink data.
successful = this.theInkAnalyzer.Load(theSavedResults);
Platforms
Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008
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