InkAnalyzer.AddStrokes, méthode (StrokeCollection)

Article
11/05/2008

Mise à jour : November 2007

Ajoute le StrokeCollection spécifié au InkAnalyzer et assigne à chacun des traits l'identificateur de paramètres régionaux du thread d'entrée actif.

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

Syntaxe

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

returnValue = instance.AddStrokes(strokesToAdd)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd
)

public:
ContextNode^ AddStrokes(
    StrokeCollection^ strokesToAdd
)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd
)

public function AddStrokes(
    strokesToAdd : StrokeCollection
) : ContextNode

Paramètres

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

Valeur de retour

Type : System.Windows.Ink.ContextNode
ContextNode auquel strokesToAdd est ajouté.

Notes

InkAnalyzer ajoute le StrokeCollection à un UnclassifiedInkNode dans la collection SubNodes de la propriété RootNode. Un identificateur de paramètres régionaux pour le thread d'entrée actif est assigné à chaque trait dans la collection StrokeCollection, strokesToAdd. Chaque trait dans la collection est également ajouté au premier UnclassifiedInkNode qui contient 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.