InkAnalyzer.AddStrokes, méthode (StrokeCollection, Int32)

Article
11/05/2008

Mise à jour : November 2007

Ajoute un StrokeCollection au InkAnalyzer et assigne un identificateur de paramètres régionaux spécifique à chacun des traits.

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

Syntaxe

'Déclaration
Public Function AddStrokes ( _
    strokesToAdd As StrokeCollection, _
    languageId As Integer _
) As ContextNode
'Utilisation
Dim instance As InkAnalyzer
Dim strokesToAdd As StrokeCollection
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd, _
    languageId)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd,
    int languageId
)

public:
ContextNode^ AddStrokes(
    StrokeCollection^ strokesToAdd, 
    int languageId
)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd,
    int languageId
)

public function AddStrokes(
    strokesToAdd : StrokeCollection, 
    languageId : int
) : ContextNode

Paramètres

strokesToAdd
Type : System.Windows.Ink.StrokeCollection
StrokeCollection à ajouter au InkAnalyzer.

languageId
Type : System.Int32
Identificateur de paramètres régionaux assigné aux traits dans la collection strokesToAdd.

Valeur de retour

Type : System.Windows.Ink.ContextNode
ContextNode auquel strokesToAdd a été ajouté.

Notes

InkAnalyzer ajoute le StrokeCollection à un UnclassifiedInkNode dans la collection SubNodes de la propriété RootNode. Chaque trait de la collection StrokeCollection, strokesToAdd, est assigné à l'identificateur de paramètres régionaux languageId et ajouté au premier UnclassifiedInkNode contenant des traits possédant le même identificateur de paramètres régionaux. Si aucun UnclassifiedInkNode correspondant n'existe, un UnclassifiedInkNode est créé et strokesToAdd est ajouté au nouveau UnclassifiedInkNode.

Cette méthode étend la propriété DirtyRegion à l'union de la valeur actuelle de la région et du cadre englobant des traits ajoutés.

Si l'un de ces traits est déjà attaché au InkAnalyzer, InkAnalyzer lève une exception.

Exemples

L'exemple suivant crée un InkAnalyzer et attache le gestionnaire d'événements StrokesChanged à la propriété Strokes dans un InkCanvas, nommé theInkCanvas.

theInkAnalyzer = New InkAnalyzer()

AddHandler theInkCanvas.Strokes.StrokesChanged, AddressOf Strokes_StrokesChanged

theInkAnalyzer = new InkAnalyzer();

theInkCanvas.Strokes.StrokesChanged += 
    new StrokeCollectionChangedEventHandler(Strokes_StrokesChanged);

L'exemple suivant définit le gestionnaire d'événements Strokes_StrokesChanged, qui ajoute des traits à theInkAnalyzer s'ils ont déjà été ajoutés à theInkCanvas. Il supprime également des traits de theInkAnalyzer s'ils ont déjà été supprimés de theInkCanvas.

' This event occurs whenever a stroke is added, removed, or partially erased
' from the InkCanvas.
Sub Strokes_StrokesChanged(ByVal sender As Object, ByVal e As StrokeCollectionChangedEventArgs) 
    If e.Added.Count > 0 Then
        theInkAnalyzer.AddStrokes(e.Added)
    End If

    If e.Removed.Count > 0 Then
        theInkAnalyzer.RemoveStrokes(e.Removed)
    End If

End Sub 'Strokes_StrokesChanged

// This event occurs whenever a stroke is added, removed, or partially erased
// from the InkCanvas.
void Strokes_StrokesChanged(object sender, StrokeCollectionChangedEventArgs e)
{
    if (e.Added.Count > 0)
    {
        theInkAnalyzer.AddStrokes(e.Added);
    }

    if (e.Removed.Count > 0)
    {
        theInkAnalyzer.RemoveStrokes(e.Removed);
    }
}

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.