InkAnalyzer.AddStrokes (Método) (StrokeCollection, Int32)

Artículo
11/26/2008

Actualización: noviembre 2007

Agrega una colección StrokeCollection al objeto InkAnalyzer y asigna un identificador de configuración regional a cada trazo.

Espacio de nombres: System.Windows.Ink
Ensamblado: IAWinFX (en IAWinFX.dll)

Sintaxis

'Declaración
Public Function AddStrokes ( _
    strokesToAdd As StrokeCollection, _
    languageId As Integer _
) As ContextNode
'Uso
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

Parámetros

strokesToAdd
Tipo: System.Windows.Ink.StrokeCollection
StrokeCollection que se va a agregar a InkAnalyzer.

languageId
Tipo: System.Int32
Identificador de configuración regional asignado a los trazos de la colección strokesToAdd.

Valor devuelto

Tipo: System.Windows.Ink.ContextNode
Objeto ContextNode al que se agregó strokesToAdd.

Comentarios

El objeto InkAnalyzer agrega StrokeCollection a un objeto UnclassifiedInkNode de la colección SubNodes de la propiedad RootNode. A cada trazo de la colección StrokeCollection, strokesToAdd, se le asigna el identificador de configuración regional languageId y se agrega al primer objeto UnclassifiedInkNode que contenga trazos con el mismo identificador de configuración regional. Si no existe este objeto UnclassifiedInkNode, se crea un nuevo objeto UnclassifiedInkNode y se agrega strokesToAdd al nuevo objeto UnclassifiedInkNode.

Este método expande la propiedad DirtyRegion a la unión del valor actual de la región y el cuadro de límite de los trazos agregados.

Si cualquiera de los trazos ya está asociado al objeto InkAnalyzer, dicho objeto InkAnalyzer produce una excepción.

Ejemplos

En el ejemplo siguiente se crea un nuevo objeto InkAnalyzer y se asocia el controlador de eventos StrokesChanged a la propiedad Strokes del objeto InkCanvas, que se denomina theInkCanvas.

theInkAnalyzer = New InkAnalyzer()

AddHandler theInkCanvas.Strokes.StrokesChanged, AddressOf Strokes_StrokesChanged

theInkAnalyzer = new InkAnalyzer();

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

En el ejemplo siguiente, se define el controlador de eventos Strokes_StrokesChanged, que agrega trazos a theInkAnalyzer si ya se agregaron a theInkCanvas. También quita los trazos de theInkAnalyzer si ya se quitaron 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);
    }
}

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.