InkAnalyzer.Load-Methode (Stream, Boolean)

Artikel
10/28/2008

Lädt gespeicherte Analyseergebnisse in InkAnalyzer.

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

Syntax

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

returnValue = instance.Load(stream, doNotAutoAddStrokes)

public bool Load(
    Stream stream,
    bool doNotAutoAddStrokes
)

public:
bool Load(
    Stream^ stream, 
    bool doNotAutoAddStrokes
)

public boolean Load(
    Stream stream,
    boolean doNotAutoAddStrokes
)

public function Load(
    stream : Stream, 
    doNotAutoAddStrokes : boolean
) : boolean

Parameter

stream
Typ: System.IO.Stream
Ein Stream, der die gespeicherten Analyseergebnisse enthält.

doNotAutoAddStrokes
Typ: System.Boolean
true , um Striche auszuschließen, die einem InkAnalyzer vorher nicht hinzugefügt wurden; andernfalls false.

Rückgabewert

Typ: System.Boolean
true , wenn die Analyseergebnisse erfolgreich geladen wurden, andernfalls false.

Hinweise

Auf anderen Ebenen der Freihandanalyse, wie beispielsweise dem Windows Forms-Layer, ist das Freihandanalysemodul in der Lage, Striche zu speichern, ohne sie hinzuzufügen. Wenn für doNotAutoAddStrokestrue festgelegt ist, ignoriert der InkAnalyzer Striche, die dem Freihandanalysemodul beim Speichern nicht hinzugefügt wurden.

Hinweis

Der in Windows Presentation Foundation enthaltene InkAnalyzer speichert keine Striche, die nicht zum InkAnalyzer hinzugefügt wurden. Beim Speichern der Freihandeingabe durch den System.Windows.Ink.InkAnalyzer hat doNotAutoAddStroke keinen Einfluss auf das Verhalten der Load(Stream, Boolean)-Methode.

Wenn der InkAnalyzer einen ContextNode aus den gespeicherten Ergebnissen hinzufügt, weist er der Id()-Eigenschaft des ContextNode-Objekts eine neue GUID (Globally Unique Identifier) zu.

Diese Methode fügt die gespeicherten Analyseergebnisse an vorhandene Ergebnisse an. Fügen Sie den Bereich, der die geladenen Kontextknoten enthält, der DirtyRegion des Freihandanalysemoduls hinzu, um sicherzustellen, dass die kombinierten Ergebnisse korrekt sortiert werden.

Wenn ein gespeicherter Analysehinweis in Konflikt mit einem vorhandenen Analysehinweis steht, wird der gespeicherte Hinweis vom InkAnalyzer nicht geladen, jedoch aber der Rest der gespeicherten Ergebnisse. Wenn gespeicherte Strichdaten sich jedoch innerhalb des Bereichs eines gespeicherten Analysehinweises befinden, der nicht geladen wird, fügt der InkAnalyzer das umgebende Feld des Strichs der DirtyRegion des Analysemoduls hinzu. Wenn gespeicherte Strichdaten sich innerhalb des Bereichs eines vorhandenen Analysehinweises befinden, fügt das Analysemodul das umgebende Feld des Strichs der DirtyRegion des Analysemoduls hinzu. Weitere Informationen über Analysehinweise finden Sie unter AnalysisHintNode.

Der InkAnalyzer löst beim Laden der gespeicherten Ergebnisse die Ereignisse ContextNodeCreated, ContextNodeLinkAdding und ContextNodePropertiesUpdated aus.

Beispiele

In diesem Beispiel werden gespeicherte Analyseergebnisse aus einem MemoryStream mit dem Namen theSavedResults in einen InkAnalyzer mit dem Namen theInkAnalyzer geladen.

' Load previously saved analysis results, but do not load
' associated ink data.
successful = Me.theInkAnalyzer.Load(theSavedResults, True)

// Load previously saved analysis results, but do not load
// associated ink data.
successful = this.theInkAnalyzer.Load(theSavedResults, true);

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.