InkAnalyzer.AddStroke (Método) (Stroke)

Artículo
10/28/2008

Actualización: noviembre 2007

Agrega un objeto Stroke al objeto InkAnalyzer y asigna el identificador de configuración regional del subproceso de entrada activo al trazo.

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

Sintaxis

'Declaración
Public Function AddStroke ( _
    strokeToAdd As Stroke _
) As ContextNode
'Uso
Dim instance As InkAnalyzer
Dim strokeToAdd As Stroke
Dim returnValue As ContextNode

returnValue = instance.AddStroke(strokeToAdd)

public ContextNode AddStroke(
    Stroke strokeToAdd
)

public:
ContextNode^ AddStroke(
    Stroke^ strokeToAdd
)

public ContextNode AddStroke(
    Stroke strokeToAdd
)

public function AddStroke(
    strokeToAdd : Stroke
) : ContextNode

Parámetros

strokeToAdd
Tipo: Microsoft.Ink.Stroke
Objeto Stroke que se va a agregar al objeto InkAnalyzer.

Valor devuelto

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

Comentarios

El objeto InkAnalyzer agrega Stroke a un objeto UnclassifiedInkNode de la colección SubNodes de la propiedad RootNode. Al objeto Stroke, strokeToAdd, se le asigna el identificador de configuración regional del subproceso de entrada activo 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 del trazo agregado.

Si el trazo 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.InkCollector, theInkCollector.
Asocia un controlador de eventos InkCollector.Stroke, theInkCollector_Stroke, a theInkCollector.
Inicializa un nuevo objeto InkAnalyzer, theInkAnalyzer, que puede analizar los datos de los trazos de la propiedad Ink del objeto InkCollector.

' Create and enable the InkCollector and attach event handlers.
Me.theInkCollector = New Microsoft.Ink.InkCollector(Me.theInkingPanel)
AddHandler Me.theInkCollector.Stroke, AddressOf Me.theInkCollector_Stroke
Me.theInkCollector.Enabled = True

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

// Create and enable the InkCollector and attach event handlers.
this.theInkCollector =
    new Microsoft.Ink.InkCollector(this.theInkingPanel);
this.theInkCollector.Stroke +=
    new Microsoft.Ink.InkCollectorStrokeEventHandler(
        this.theInkCollector_Stroke);
this.theInkCollector.Enabled = true;

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

En este ejemplo, el controlador de eventos theInkCollector_Stroke toma a continuación el trazo que se ha agregado a theInkCollector y lo agrega a theInkAnalyzer.

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

    ' Add the new stroke to the InkAnalyzer.
    Me.theInkAnalyzer.AddStroke(e.Stroke)

End Sub 'theInkCollector_Stroke

/// <summary>
/// The ink collector's Stroke event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkCollector_Stroke(
    object sender, Microsoft.Ink.InkCollectorStrokeEventArgs e)
{
    // Add the new stroke to the InkAnalyzer.
    this.theInkAnalyzer.AddStroke(e.Stroke);
}

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.