Metodo InkAnalyzer.AddStroke (Stroke)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Aggiunge un oggetto Stroke all'oggetto InkAnalyzer e assegna al tratto l'identificatore delle impostazioni locali del thread di input attivo.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
Public Function AddStroke ( _
    strokeToAdd As Stroke _
) As ContextNode
'Utilizzo
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

Parametri

strokeToAdd
Tipo: Microsoft.Ink.Stroke
Oggetto Stroke da aggiungere a InkAnalyzer.

Valore restituito

Tipo: Microsoft.Ink.ContextNode
Oggetto ContextNode a cui è stato aggiunto l'oggetto strokeToAdd.

Note

L'oggetto InkAnalyzer aggiunge l'oggetto Stroke a un oggetto UnclassifiedInkNode nell'insieme SubNodes della proprietà RootNode. All'oggetto Stroke, strokeToAdd viene assegnato l'identificatore delle impostazioni locali del thread di input attivo e viene aggiunto al primo oggetto UnclassifiedInkNode contenente i tratti con lo stesso identificatore delle impostazioni locali. Se non esiste alcun oggetto UnclassifiedInkNode, viene creato un nuovo oggetto UnclassifiedInkNode e strokeToAdd viene aggiunto al nuovo oggetto UnclassifiedInkNode.

Questo metodo espande l'oggetto DirtyRegion all'unione del valore corrente dell'area e del riquadro del tratto aggiunto.

Se il tratto è già associato all'oggetto InkAnalyzer, l'oggetto InkAnalyzer genera un'eccezione.

Esempi

In questo esempio vengono eseguite le operazioni seguenti.

Inizializza un nuovo oggetto Microsoft.Ink.InkCollector, theInkCollector.
Associa un gestore eventi InkCollector.Stroke, theInkCollector_Stroke all'oggetto theInkCollector.
Inizializza un nuovo oggetto InkAnalyzer, theInkAnalyzer che può analizzare i dati del tratto della proprietà Ink dell'oggetto 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);

In questo esempio, il gestore eventi theInkCollector_Stroke utilizza il tratto che è stato aggiunto all'oggetto theInkCollector e lo aggiunge all'oggetto 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);
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.