Metodo InkAnalyzer.AddStroke (Stroke, Int32)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Aggiunge un tratto all'oggetto InkAnalyzer e assegna al tratto uno specifico identificatore delle impostazioni locali.

Spazio dei nomi: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Sintassi

'Dichiarazione
Public Function AddStroke ( _
    strokeToAdd As Stroke, _
    languageId As Integer _
) As ContextNode
'Utilizzo
Dim instance As InkAnalyzer
Dim strokeToAdd As Stroke
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStroke(strokeToAdd, _
    languageId)

public ContextNode AddStroke(
    Stroke strokeToAdd,
    int languageId
)

public:
ContextNode^ AddStroke(
    Stroke^ strokeToAdd, 
    int languageId
)

public ContextNode AddStroke(
    Stroke strokeToAdd,
    int languageId
)

public function AddStroke(
    strokeToAdd : Stroke, 
    languageId : int
) : ContextNode

Parametri

strokeToAdd
Tipo: System.Windows.Ink.Stroke
Oggetto Stroke da aggiungere a InkAnalyzer.

languageId
Tipo: System.Int32
Identificatore delle impostazioni locali assegnato all'oggetto strokeToAdd.

Valore restituito

Tipo: System.Windows.Ink.ContextNode
Oggetto ContextNode a cui viene aggiunto l'oggetto strokeToAdd.

Note

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 languageId. Quindi, l'oggetto Stroke 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, InkAnalyzer genera un'eccezione.

Esempi

In questo esempio vengono eseguite le operazioni indicate di seguito.

Viene inizializzato un nuovo oggetto InkCollector denominato theInkCollector.
Viene associato un gestore per l'evento InkCollectorStroke(), denominato theInkCollector_Stroke, all'oggetto theInkCollector.

Viene inizializzato un nuovo oggetto InkAnalyzer, denominato theInkAnalyzer, che analizza i dati del tratto ricevuti dall'oggetto Ink() dell'oggetto InkCollector.

' Create the InkAnalyzer.
theInkAnalyzer = New InkAnalyzer()

' Attach an event handler to the InkCanvas.StrokeCollected event.
AddHandler theInkCanvas.StrokeCollected, AddressOf InkArea_StrokeCollected

// Create the InkAnalyzer.
theInkAnalyzer = new InkAnalyzer();

// Attach an event handler to the InkCanvas.StrokeCollected event.
theInkCanvas.StrokeCollected += 
    new InkCanvasStrokeCollectedEventHandler(InkArea_StrokeCollected);

In questo esempio, il gestore eventi theInkCollector_Stroke prende il tratto aggiunto a theInkCollector, l'aggiunge a theInkAnalyzer e gli assegna un identificatore delle impostazioni locali specifico denominato theLanguageId.

Sub InkCamvas_StrokeCollected(ByVal sender As Object, ByVal e As InkCanvasStrokeCollectedEventArgs)
    theInkAnalyzer.AddStroke(e.Stroke, Me.theLangageId)

End Sub 'InkCamvas_StrokeCollected

void InkCamvas_StrokeCollected(object sender, InkCanvasStrokeCollectedEventArgs e)
{
    theInkAnalyzer.AddStroke(e.Stroke, this.theLangageId);
}

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.