InkAnalyzer.Load Method (Stream)

Článek
10/19/2012

Loads saved analysis results into the InkAnalyzer.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public Function Load ( _
    stream As Stream _
) As Boolean
'Usage
Dim instance As InkAnalyzer 
Dim stream As Stream 
Dim returnValue As Boolean 

returnValue = instance.Load(stream)

public bool Load(
    Stream stream
)

public:
bool Load(
    Stream^ stream
)

public function Load(
    stream : Stream
) : boolean

Parameters

stream
Type: System.IO.Stream

A stream that contains the saved analysis results.

Return Value

Type: System.Boolean
true if the analysis results loaded successfully; otherwise, false.

Remarks

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 then reanalyze the ink.

If a saved analysis hint conflicts with an existing analysis hint, the InkAnalyzer does not load that saved hint although it loads the rest of the saved results. However, if saved stroke data is within the area of an unloaded saved analysis hint, the InkAnalyzer adds the bounding box of the stroke to the analyzer's DirtyRegion. 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 saved results.

Examples

This example loads saved analysis results from a MemoryStream named theSavedResults into the InkAnalyzer, named theInkAnalyzer.

' 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 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

Sdílet prostřednictvím