InkAnalyzer.Load (Método) (array<Byte[], Boolean)

Artículo
11/26/2008

Actualización: noviembre 2007

Carga los resultados del análisis guardados en InkAnalyzer. Opcionalmente carga los datos de la entrada manuscrita en el objeto Microsoft.Ink.Ink asociado.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.dll)

Sintaxis

'Declaración
Public Function Load ( _
    serializedResults As Byte(), _
    doNotAutoAddStrokes As Boolean _
) As Boolean
'Uso
Dim instance As InkAnalyzer
Dim serializedResults As Byte()
Dim doNotAutoAddStrokes As Boolean
Dim returnValue As Boolean

returnValue = instance.Load(serializedResults, _
    doNotAutoAddStrokes)

public bool Load(
    byte[] serializedResults,
    bool doNotAutoAddStrokes
)

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

public boolean Load(
    byte[] serializedResults,
    boolean doNotAutoAddStrokes
)

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

Parámetros

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

doNotAutoAddStrokes
Tipo: System.Boolean
Es true para no agregar los datos de la entrada manuscrita guardada a la entrada manuscrita asociada; en caso contrario, es false.

Valor devuelto

Tipo: System.Boolean
Es true si los resultados del análisis se cargaron correctamente; en caso contrario, es false.

Comentarios

Si los datos de la entrada manuscrita se incluyen en los resultados del análisis y doNotAutoAddStrokes es false, el objeto InkAnalyzer agrega los trazos guardados a la propiedad Ink del analizador de entrada manuscrita.

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

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

Si el objeto InkAnalyzer agrega los trazos guardados al objeto Microsoft.Ink.Ink asociado, los resultados del análisis cargados harán referencia a los trazos cargados en la entrada manuscrita.

Si el analizador no agrega los trazos guardados al objeto Microsoft.Ink.Ink asociado, el analizador comparará los identificadores de trazos de los resultados guardados con los identificadores de trazos del objeto Microsoft.Ink.Ink el existente para asociar los resultados del análisis cargados a los trazos existentes.

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 los datos de trazo guardados están dentro del área de una sugerencia de análisis guardada que no se carga, el analizador agregará el cuadro de límite del trazo a la propiedad DirtyRegion del analizador. A su vez, si los datos de trazo guardados están dentro del área de una sugerencia de análisis existente, el analizador también agregará el cuadro de límite del trazo a la propiedad DirtyRegion del analizador Para obtener más información sobre las sugerencias de análisis, vea AnalysisHintNode.

El objeto InkAnalyzer provoca los eventos ContextNodeCreated, ContextNodePropertiesUpdated y ContextNodeLinkAdding cuando carga los resultados guardados.

Ejemplos

En este ejemplo se cargan los resultados del análisis guardados de una matriz de enteros de 8 bits sin signo, theSavedResults, en el objeto InkAnalyzer, theInkAnalyzer. Sin embargo, no carga los datos de la entrada manuscrita guardados en el objeto Microsoft.Ink.Ink asociado del analizador.

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

Plataformas

Windows Vista

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