InkAnalyzerBase.Load (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Carga los resultados del análisis guardados en el analizador de entrada manuscrita.

Espacio de nombres: System.Windows.Ink.AnalysisCore
Ensamblado: IACore (en IACore.dll)

Sintaxis

'Declaración
Public Function Load ( _
    serializedResults As Byte(), _
    originalToNewStrokeIdMap As Hashtable _
) As Boolean
'Uso
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

Parámetros

serializedResults
Tipo: array<System.Byte[]
Matriz de enteros de 8 bits sin signo que contiene los resultados guardados del análisis.

originalToNewStrokeIdMap
Tipo: System.Collections.Hashtable
Asignación de los identificadores de trazo anteriores a los nuevos identificadores de trazo, o nullreferencia null (Nothing en Visual Basic) para mantener los identificadores de trazo originales.

Valor devuelto

Tipo: System.Boolean
true si el analizador de entrada manuscrita cargó los resultados del análisis; de lo contrario, false.

Comentarios

Cuando el analizador de entrada manuscrita agrega un objeto ContextNodeBase de los resultados guardados, asigna un nuevo identificador único global (GUID) a la propiedad Id del objeto ContextNodeBase.

Este método agrega los resultados guardados del análisis al árbol ContextNodeBase existente. Para asegurarse de que los resultados combinados se ordenan correctamente, agregue el área que contiene los nodos de contexto cargados a la propiedad DirtyRegion del analizador de entrada manuscrita y vuelva a analizarla.

El método SaveResults no guarda los datos de paquete junto con los resultados del análisis.

Cada clave de originalToNewStrokeIdMap es el identificador del trazo que se encuentra en los resultados guardados del análisis. Cada valor de originalToNewStrokeIdMap es el nuevo identificador con el que se va a reemplazar el identificador original de los resultados del análisis cargados.

Si una sugerencia de análisis guardada no concuerda con una sugerencia de análisis existente, el analizador de entrada manuscrita no carga la sugerencia guardada pero sí carga el resto de los resultados guardados. Sin embargo, si el analizador carga los resultados para un trazo que está dentro del área de una sugerencia de análisis guardada que el analizador no carga, el analizador agrega el cuadro de límite del trazo a la propiedad DirtyRegion del objeto InkAnalyzerBase. Asimismo, si el analizador carga los resultados para un trazo que está dentro del área de una sugerencia de análisis existente, el analizador también agrega el cuadro de límite del trazo a la propiedad DirtyRegion del objeto InkAnalyzerBase. Para obtener más información sobre las sugerencias de análisis, vea PropertyGuidsForAnalysisHintsBase.

El objeto InkAnalyzerBase provoca los eventos ContextNodeCreatedBase, ContextNodePropertiesUpdatedBase y ContextNodeLinkAddingBase cuando carga los resultados guardados.

Ejemplos

En el ejemplo siguiente se cargan los resultados del análisis guardados de la matriz de enteros de 8 bits sin signo, savedResults. En el ejemplo, se cargan los resultados en el objeto InkAnalyzerBase, theInkAnalyzerBase. En este ejemplo no se muestra cómo calcular los nuevos identificadores de trazo cuando el analizador de entrada manuscrita ya contiene datos de trazo.

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

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.