InkAnalyzer.AddStroke, méthode (Stroke)

Article
11/05/2008

Mise à jour : November 2007

Ajoute un Stroke au InkAnalyzer et assigne au trait l'identificateur de paramètres régionaux du thread d'entrée actif.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.dll)

Syntaxe

'Déclaration
Public Function AddStroke ( _
    strokeToAdd As Stroke _
) As ContextNode
'Utilisation
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

Paramètres

strokeToAdd
Type : Microsoft.Ink.Stroke
Stroke à ajouter au InkAnalyzer.

Valeur de retour

Type : Microsoft.Ink.ContextNode
ContextNode auquel strokeToAdd a été ajouté.

Notes

InkAnalyzer ajoute le Stroke à un UnclassifiedInkNode dans la collection SubNodes de la propriété RootNode. L'identificateur de paramètres régionaux du thread d'entrée actif est assigné à Stroke, strokeToAdd, et ce dernier est ajouté au premier UnclassifiedInkNode contenant des traits possédant le même identificateur de paramètres régionaux. Si aucun UnclassifiedInkNode correspondant n'existe, un UnclassifiedInkNode est créé et strokeToAdd est ajouté au nouveau UnclassifiedInkNode.

Cette méthode étend la propriété DirtyRegion à l'union de la valeur actuelle de la région et du cadre englobant du trait ajouté.

Si le trait est déjà attaché à l'InkAnalyzer, le InkAnalyzer lève une exception.

Exemples

Cet exemple effectue les actions suivantes.

Initialise un nouvel objet Microsoft.Ink.InkCollector, theInkCollector.
Attache un gestionnaire d'événements InkCollector.Stroke, theInkCollector_Stroke, à theInkCollector.
Initialise un nouveau InkAnalyzer, theInkAnalyzer, qui peut analyser les données de trait à partir de la propriété Ink de l'objet 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);

Dans cet exemple, le gestionnaire d'événements theInkCollector_Stroke prend ensuite le trait qui a été ajouté au theInkCollector et l'ajoute à 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);
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.