InkAnalyzerBase.AddStroke-Methode (Int32, array<Int32[], array<Guid[])

Artikel
11/26/2008

Fügt dem Freihandanalysemodul Strichdaten für einen einzelnen Strich hinzu und weist dem Strich den Kulturbezeichner des aktiven Eingabethreads zu.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

'Declaration
Public Function AddStroke ( _
    strokeId As Integer, _
    strokePacketData As Integer(), _
    strokePacketDescription As Guid() _
) As ContextNodeBase
'Usage
Dim instance As InkAnalyzerBase
Dim strokeId As Integer
Dim strokePacketData As Integer()
Dim strokePacketDescription As Guid()
Dim returnValue As ContextNodeBase

returnValue = instance.AddStroke(strokeId, _
    strokePacketData, strokePacketDescription)

public ContextNodeBase AddStroke(
    int strokeId,
    int[] strokePacketData,
    Guid[] strokePacketDescription
)

public:
ContextNodeBase^ AddStroke(
    int strokeId, 
    array<int>^ strokePacketData, 
    array<Guid>^ strokePacketDescription
)

public ContextNodeBase AddStroke(
    int strokeId,
    int[] strokePacketData,
    Guid[] strokePacketDescription
)

public function AddStroke(
    strokeId : int, 
    strokePacketData : int[], 
    strokePacketDescription : Guid[]
) : ContextNodeBase

Parameter

strokeId
Typ: System.Int32
Der Strichbezeichner.

strokePacketData
Typ: array<System.Int32[]
Ein Array, das die Paketdaten für den Strich enthält.

strokePacketDescription
Typ: array<System.Guid[]
Ein Array, das die Eigenschaftenbezeichner für Pakete enthält.

Rückgabewert

Typ: System.Windows.Ink.AnalysisCore.ContextNodeBase
Der Kontextknoten, dem das Freihandanalysemodul den Strich hinzugefügt hat.

Hinweise

InkAnalyzerBase fügt den Strich einem ContextNodeBase-Objekt hinzu, das über einen Type-Eigenschaftswert von UnclassifiedInk verfügt.

Das Freihandanalysemodul weist dem Strich den Kulturbezeichner des aktiven Eingabethreads zu und fügt den Strich dem ersten nicht klassifizierten Freihandknoten unter dem Stammknoten des Freihanderkennungsmoduls hinzu, der Striche mit demselben Kulturbezeichner enthält. Wenn das Freihandanalysemodul keinen Knoten mit demselben Kulturbezeichner finden kann, erstellt es einen ContextNodeBase unter seinem Stammknoten und fügt den Strich dem neuen nicht klassifizierten Freihandknoten hinzu.

strokePacketData enthält Paketdaten für alle Punkte im Strich. strokePacketDescription enthält die GUIDs (Globally Unique Identifier), die die Paketdatentypen beschreiben, die für die einzelnen Punkte im Strich enthalten sind. Eine vollständige Liste der verfügbaren Paketeigenschaften finden Sie unter der PacketProperty-Klasse.

Diese Methode erweitert den DirtyRegion auf die Gesamtmenge des aktuellen Werts des Bereichs und des umgebenden Felds für den hinzugefügten Strich.

Wenn InkAnalyzerBase bereits einen Strich mit demselben Bezeichner enthält, löst InkAnalyzerBase eine Ausnahme aus.

Beispiele

In diesem Beispiel wird eine Methode definiert, die einen Stroke in Paketdaten umwandelt und die Strichdaten einem InkAnalyzerBase hinzufügt. Die Methode gibt die ContextNodeBase zurück, der das Freihandanalysemodul den Strich hinzugefügt hat.

''' <summary>
''' Adds a stroke to an InkAnalyzerBase.
''' </summary>
''' <param name="baseInkAnalyzer">
''' The analyzer that receives the stroke.</param>
''' <param name="theStroke">The stroke to add.</param>
''' <returns>The node to which the analyzer added the stroke.</returns>
''' <remarks>
''' This method converts stroke data to packet data for example only.
''' The InkAnalyzerBase is used when your application is handling packet
''' data. If your application uses stroke data from an Ink object, then
''' you would use InkAnalyzer.
''' </remarks>
Public Overloads Shared Function MyAddStroke( _
ByVal baseInkAnalyzer As System.Windows.Ink.AnalysisCore.InkAnalyzerBase, _
ByVal theStroke As Microsoft.Ink.Stroke) _
As System.Windows.Ink.AnalysisCore.ContextNodeBase
    If baseInkAnalyzer Is Nothing Then
        Throw New ArgumentNullException("baseInkAnalyzer")
    End If

    If theStroke Is Nothing Then
        Throw New ArgumentNullException("theStroke")
    End If

    ' Add a single stroke to the InkAnalyzerBase.
    Dim result As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
        baseInkAnalyzer.AddStroke(theStroke.Id, _
            theStroke.GetPacketData(), theStroke.PacketDescription)

    Return result
End Function 'AddStroke

/// <summary>
/// Adds a stroke to an InkAnalyzerBase.
/// </summary>
/// <param name="baseInkAnalyzer">
/// The analyzer that receives the stroke.</param>
/// <param name="theStroke">The stroke to add.</param>
/// <returns>The node to which the analyzer added the stroke.</returns>
/// <remarks>
/// This method converts stroke data to packet data for example only.
/// The InkAnalyzerBase is used when your application is handling packet
/// data. If your application uses stroke data from an Ink object, then
/// you would use InkAnalyzer.
/// </remarks>
public static System.Windows.Ink.AnalysisCore.ContextNodeBase MyAddStroke(
System.Windows.Ink.AnalysisCore.InkAnalyzerBase baseInkAnalyzer,
Microsoft.Ink.Stroke theStroke)
{
    if (null == baseInkAnalyzer)
    {
        throw new ArgumentNullException("baseInkAnalyzer");
    }

    if (null == theStroke)
    {
        throw new ArgumentNullException("theStroke");
    }

    // Add a single stroke to the InkAnalyzerBase.
    System.Windows.Ink.AnalysisCore.ContextNodeBase result = baseInkAnalyzer.AddStroke(
        theStroke.Id, theStroke.GetPacketData(),
        theStroke.PacketDescription);

    return result;
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.