InkAnalyzer.AddStroke, méthode (Stroke, Int32)

Article
11/05/2008

Mise à jour : November 2007

Ajoute un trait au InkAnalyzer et assigne un identificateur de paramètres régionaux spécifique au trait.

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

Syntaxe

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

Paramètres

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

languageId
Type : System.Int32
Identificateur de paramètres régionaux à assigner à strokeToAdd.

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, languageId, est assigné à Stroke, strokeToAdd, et celui-ci 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é à theInkCollector, l'ajoute à theInkAnalyzer et lui assigne un identificateur de paramètres régionaux spécifique, theLanguageId.

''' <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_Stroke2( _
    ByVal sender As Object, ByVal e As Microsoft.Ink.InkCollectorStrokeEventArgs)

    ' Add the new stroke to the InkAnalyzer using a specific language identifier.
    Me.theInkAnalyzer.AddStroke(e.Stroke, Me.theLanguageId)

End Sub 'theInkCollector_Stroke2

/// <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_Stroke2(
    object sender, Microsoft.Ink.InkCollectorStrokeEventArgs e)
{
    // Add the new stroke to the InkAnalyzer using a specific
    // language identifier.
    this.theInkAnalyzer.AddStroke(e.Stroke, this.theLanguageId);
}

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.