InkAnalyzer.Load, méthode (Stream, Boolean)

Article
11/05/2008

Mise à jour : November 2007

Charge les résultats d'analyse enregistrés dans le InkAnalyzer.

Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.dll)

Syntaxe

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

Paramètres

stream
Type : System.IO.Stream
Flux de données contenant les résultats d'analyse enregistrés.

doNotAutoAddStrokes
Type : System.Boolean
true pour exclure des traits qui n'ont pas été ajoutés précédemment à un InkAnalyzer ; sinon, false.

Valeur de retour

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

Notes

Dans d'autres couches de l'analyse d'entrée manuscrite, telles que la couche Windows Forms, l'analyseur d'entrée manuscrite peut enregistrer des traits sans les ajouter. Si doNotAutoAddStrokes a la valeur true, le InkAnalyzer ignore les traits qui n'ont pas été ajoutés à un analyseur d'entrée manuscrite lors de leur enregistrement.

Remarque :
Le InkAnalyzer fourni avec Windows Presentation Foundation n'enregistre pas les traits qui ne sont pas ajoutés au InkAnalyzer. Lorsque l'entrée manuscrite est enregistrée par le System.Windows.Ink.InkAnalyzer, doNotAutoAddStroke n'affecte pas le comportement de la méthode Load(Stream, Boolean)

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 une indication d'analyse enregistrée entre en conflit avec une indication d'analyse existante, le InkAnalyzer 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, InkAnalyzer ajoute le cadre englobant du trait à la propriété DirtyRegionde l'analyseur. 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 des résultats d'analyse enregistrés à partir d'un MemoryStream nommé theSavedResults dans un InkAnalyzer, nommé theInkAnalyzer.

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