InkAnalyzer.Load, méthode (array<Byte[], Boolean)

Article
11/05/2008

Mise à jour : November 2007

Charge les résultats d'analyse enregistrés dans le InkAnalyzer. Charge éventuellement les données d'entrée manuscrite dans l'objet Microsoft.Ink.Ink associé.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.dll)

Syntaxe

'Déclaration
Public Function Load ( _
    serializedResults As Byte(), _
    doNotAutoAddStrokes As Boolean _
) As Boolean
'Utilisation
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

Paramètres

serializedResults
Type : array<System.Byte[]
Tableau d'entiers non signés 8 bits qui contient les résultats d'analyse enregistrés.

doNotAutoAddStrokes
Type : System.Boolean
true pour ne pas ajouter de données d'entrée manuscrite enregistrées à l'entrée manuscrite associée ; sinon, false.

Valeur de retour

Type : System.Boolean
true si les résultats de l’analyse ont été chargés correctement ; sinon, false.

Notes

Si les données d'entrée manuscrite sont incluses dans les résultats d'analyse et que doNotAutoAddStrokes a la valeur false, le InkAnalyzer ajoute les traits enregistrés à la propriété Ink de l'analyseur d'entrée manuscrite.

Lorsque le InkAnalyzer ajoute un ContextNode issu des résultats enregistrés, il assigne un nouvel identificateur global unique (GUID) à la propriété Id de l'objet ContextNode.

Cette méthode ajoute aux résultats existants les résultats d'analyse enregistrés. Pour garantir que les résultats combinés sont correctement triés, ajoutez la zone contenant les nœuds de contexte chargés à la propriété DirtyRegion de l'analyseur d'entrée manuscrite et effectuez une nouvelle analyse d'entrée manuscrite.

Si le InkAnalyzer ajoute les traits enregistrés à l'objet Microsoft.Ink.Ink associé, les résultats d'analyse chargés référencent les traits chargés dans l'entrée manuscrite associée.

Si l'analyseur n'ajoute pas les traits enregistrés à l'objet Microsoft.Ink.Ink associé, il compare les identificateurs de trait des résultats enregistrés aux identificateurs de trait de l'objet Microsoft.Ink.Ink existant afin d'associer les résultats d'analyse chargés aux traits existants.

Si une indication d'analyse enregistrée entre en conflit avec une indication d'analyse existante, l'analyseur d'entrée manuscrite ne charge pas l'indication enregistrée, mais charge tout de même les résultats enregistrés restants. Toutefois, si les données de trait enregistrées se trouvent dans la zone d'une indication d'analyse enregistrée qui n'est pas chargée, l'analyseur ajoute le cadre englobant du trait à la propriété DirtyRegionde l'analyseur. De même, si les données de trait enregistrées se trouvent dans la zone d'une indication d'analyse existante, l'analyseur ajoute également le cadre englobant du trait à la propriété DirtyRegion de l'analyseur. Pour plus d'informations sur les indications d'analyse, consultez AnalysisHintNode.

InkAnalyzer déclenche les événements ContextNodeCreated, ContextNodeLinkAdding et ContextNodePropertiesUpdated au moment du chargement des résultats enregistrés.

Exemples

Cet exemple charge les résultats d'analyse enregistrés à partir d'un tableau d'entiers non signés 8 bits, theSavedResults, dans le InkAnalyzer, theInkAnalyzer. Toutefois, il ne charge pas de données d'entrée manuscrite enregistrées dans l'objet Microsoft.Ink.Ink associé de l'analyseur.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.