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

Artículo
11/26/2008

Actualización: noviembre 2007

Agrega una colección de trazos al objeto InkAnalyzer y asigna un identificador de configuración regional específico a cada trazo.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.dll)

Sintaxis

'Declaración
Public Function AddStrokes ( _
    strokesToAdd As Strokes, _
    languageId As Integer _
) As ContextNode
'Uso
Dim instance As InkAnalyzer
Dim strokesToAdd As Strokes
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd, _
    languageId)

public ContextNode AddStrokes(
    Strokes strokesToAdd,
    int languageId
)

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

public ContextNode AddStrokes(
    Strokes strokesToAdd,
    int languageId
)

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

Parámetros

strokesToAdd
Tipo: Microsoft.Ink.Strokes
Objeto Strokes que se va a agregar al objeto InkAnalyzer.

languageId
Tipo: System.Int32
El identificador de idioma que se va a asignar a los trazos de la colección strokesToAdd.

Valor devuelto

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

Comentarios

El objeto InkAnalyzer agrega Strokes a un objeto UnclassifiedInkNode de la colección SubNodes de la propiedad RootNode. A cada trazo de la colección Strokes, 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 strokeToAdd 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

Este ejemplo realiza lo siguiente.

Inicializa un nuevo objeto Microsoft.Ink.Ink, theInk.
Asocia un controlador de eventos Ink.InkAdded, theInk_InkAdded2, a theInk.
Inicializa un nuevo objeto InkAnalyzer, theInkAnalyzer, que puede analizar los datos de los trazos de theInk.

' Create the Ink for use with the InkCollector and attach
' event handlers.
Me.theInk = New Microsoft.Ink.Ink()
AddHandler Me.theInk.InkAdded, AddressOf theInk_InkAdded

' Create the InkAnalyzer.
Me.theInkAnalyzer = New Microsoft.Ink.InkAnalyzer(Me.theInk, Me)

// Create the Ink for use with the InkCollector and attach
// event handlers.
this.theInk = new Microsoft.Ink.Ink();
this.theInk.InkAdded +=
    new Microsoft.Ink.StrokesEventHandler(theInk_InkAdded);

// Create the InkAnalyzer.
this.theInkAnalyzer =
    new Microsoft.Ink.InkAnalyzer(this.theInk, this);

En este ejemplo, el controlador de eventos theInk_InkAdded2 toma a continuación los trazos que se han agregado a theInk, los agrega a theInkAnalyzer y les asigna un identificador de configuración regional específico, theLanguageId.

''' <summary>
''' The ink's InkAdded event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Sub theInk_InkAdded2( _
    ByVal sender As Object, ByVal e As Microsoft.Ink.StrokesEventArgs)

    ' This event handler is attached to an Ink object.
    Dim theInk As Microsoft.Ink.Ink = DirectCast(sender, Microsoft.Ink.Ink)

    ' Add the new strokes to the InkAnalyzer using a specific language identifier.
    Me.theInkAnalyzer.AddStrokes( _
        theInk.CreateStrokes(e.StrokeIds), Me.theLanguageId)
End Sub 'theInk_InkAdded2

/// <summary>
/// The ink's InkAdded event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInk_InkAdded2(object sender, Microsoft.Ink.StrokesEventArgs e)
{
    // This event handler is attached to an Ink object.
    Microsoft.Ink.Ink theInk = sender as Microsoft.Ink.Ink;

    // Add the new strokes to the InkAnalyzer using a specific
    // language identifier.
    this.theInkAnalyzer.AddStrokes(
        theInk.CreateStrokes(e.StrokeIds), this.theLanguageId);
}

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.