Metodo InkAnalyzerBase.Load

Articolo
10/29/2008

Aggiornamento: novembre 2007

Carica nell'analizzatore dell'input penna i risultati dell'analisi salvati.

Spazio dei nomi: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Sintassi

'Dichiarazione
Public Function Load ( _
    serializedResults As Byte(), _
    originalToNewStrokeIdMap As Hashtable _
) As Boolean
'Utilizzo
Dim instance As InkAnalyzerBase
Dim serializedResults As Byte()
Dim originalToNewStrokeIdMap As Hashtable
Dim returnValue As Boolean

returnValue = instance.Load(serializedResults, _
    originalToNewStrokeIdMap)

public bool Load(
    byte[] serializedResults,
    Hashtable originalToNewStrokeIdMap
)

public:
bool Load(
    array<unsigned char>^ serializedResults, 
    Hashtable^ originalToNewStrokeIdMap
)

public boolean Load(
    byte[] serializedResults,
    Hashtable originalToNewStrokeIdMap
)

public function Load(
    serializedResults : byte[], 
    originalToNewStrokeIdMap : Hashtable
) : boolean

Parametri

serializedResults
Tipo: array<System.Byte[]
Matrice di valori integer senza segno a 8 bit che contiene i risultati dell'analisi salvati.

originalToNewStrokeIdMap
Tipo: System.Collections.Hashtable
Mapping di identificatori del tratto obsoleti ai nuovi identificatori del tratto oppure nullriferimento null (Nothing in Visual Basic) per mantenere gli identificatori del tratto originali.

Valore restituito

Tipo: System.Boolean
true se l'analizzatore dell'input penna ha caricato i risultati dell'analisi; in caso contrario, false.

Note

Quando l'analizzatore dell'input penna aggiunge un oggetto ContextNodeBase dai risultati salvati, assegna un nuovo GUID alla proprietà Id dell'oggetto ContextNodeBase.

Questo metodo aggiunge i risultati dell'analisi salvati alla struttura ad albero ContextNodeBase esistente. Per essere certi che i risultati combinati vengano ordinati correttamente, aggiungere l'area contenente i nodi di contesto caricati all'oggetto DirtyRegion dell'analizzatore dell'input penna e analizzare di nuovo l'input penna.

Il metodo SaveResults non salva i dati del pacchetto insieme ai risultati di analisi.

Ogni chiave in originalToNewStrokeIdMap è l'identificatore di tratto per il tratto nei risultati di analisi salvati. Ogni valore in originalToNewStrokeIdMap è il nuovo identificatore con il quale sostituire l'identificatore originale nei risultati di analisi caricati.

Se un suggerimento di analisi salvato è in conflitto con un suggerimento di analisi esistente, l'analizzatore dell'input penna non carica il suggerimento salvato, ma carica gli altri risultati salvati. Tuttavia, se l'analizzatore carica i risultati per un tratto che si trova all'interno dell'area di un suggerimento di analisi salvato non caricato dall'analizzatore, quest'ultimo aggiunge il riquadro del tratto alla proprietà DirtyRegion dell'oggetto InkAnalyzerBase. Inoltre, se l'analizzatore carica i risultati per un tratto che si trova all'interno dell'area di un suggerimento di analisi esistente, l'analizzatore aggiunge anche il riquadro del tratto alla proprietà DirtyRegion dell'oggetto InkAnalyzerBase. Per ulteriori informazioni sui suggerimenti di analisi, vedere PropertyGuidsForAnalysisHintsBase.

L'oggetto InkAnalyzerBase genera gli eventi ContextNodeCreatedBase, ContextNodeLinkAddingBase e ContextNodePropertiesUpdatedBase quando carica i risultati salvati.

Esempi

Nell'esempio seguente vengono caricati i risultati dell'analisi salvati da una matrice di valori integer senza segno a 8 bit, savedResults. Nell'esempio vengono caricati i risultati nell'oggetto InkAnalyzerBase, theInkAnalyzerBase. In questo esempio non viene illustrato come calcolare i nuovi identificatori del tratto quando l'analizzatore dell'input penna contiene già i dati relativi al tratto.

' Load previously saved analysis results
Dim successful As Boolean = False
If 0 = theInkAnalyzerBase.RootNode.GetStrokeIds().Length Then
    ' If the analyzer does not already contain stroke data, do not
    ' remap the identifiers for the strokes.
    successful = theInkAnalyzerBase.Load(savedResults, Nothing)
Else
    ' If the analyzer does already contain stroke data, remap the stroke
    ' identifiers for the saved stroke data. Then use that remapping
    ' to load the results.
End If

// Load previously saved analysis results
bool successful = false;
if (0 == theInkAnalyzerBase.RootNode.GetStrokeIds().Length)
{
    // If the analyzer does not already contain stroke data, do not
    // remap the identifiers for the strokes.
    successful = theInkAnalyzerBase.Load(savedResults, null);
}
else
{
    // If the analyzer does already contain stroke data, remap the stroke
    // identifiers for the saved stroke data. Then use that remapping
    // to load the results.
}

Piattaforme

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.