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

Artikel
11/26/2008

Fügt dem Freihandanalysemodul Strichdaten für einen einzelnen Strich hinzu und weist dem Strich einen bestimmten Kulturbezeichner 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(), _
    languageId As Integer _
) As ContextNodeBase
'Usage
Dim instance As InkAnalyzerBase
Dim strokeId As Integer
Dim strokePacketData As Integer()
Dim strokePacketDescription As Guid()
Dim languageId As Integer
Dim returnValue As ContextNodeBase

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

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

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

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

public function AddStroke(
    strokeId : int, 
    strokePacketData : int[], 
    strokePacketDescription : Guid[], 
    languageId : int
) : 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.

languageId
Typ: System.Int32
Der Kulturbezeichner, der dem Strich zugewiesen werden soll.

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 angegebenen Kulturbezeichner zu. Anschließend fügt es den Strich dem ersten nicht klassifizierten Freihandknoten unter dem Stammknoten des Freihanderkennungsmodul 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, die Strichdaten einem InkAnalyzerBase hinzufügt und dem Strich einen bestimmten Gebietsschemabezeichner zuweist. Die Methode gibt die ContextNodeBase zurück, der das Freihandanalysemodul den Strich hinzugefügt hat.

''' <summary>
''' Adds a stroke to an InkAnalyzerBase and assigns a specific
''' culture identifier to the stroke.
''' </summary>
''' <param name="baseInkAnalyzer">
''' The analyzer that receives the stroke.</param>
''' <param name="theStroke">The stroke to add.</param>
''' <param name="languageIdentifier">The culture identifier to assign to
''' the stroke.</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, _
ByVal languageIdentifier As Integer) _
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 and specify the
    ' stroke's language.
    Dim result As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
        baseInkAnalyzer.AddStroke(theStroke.Id, _
            theStroke.GetPacketData(), theStroke.PacketDescription, _
            languageIdentifier)

    Return result
End Function 'AddStroke

/// <summary>
/// Adds a stroke to an InkAnalyzerBase and assigns a specific
/// culture identifier to the stroke.
/// </summary>
/// <param name="baseInkAnalyzer">
/// The analyzer that receives the stroke.</param>
/// <param name="theStroke">The stroke to add.</param>
/// <param name="languageIdentifier">The culture identifier to assign to
/// the stroke.</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,
    int languageIdentifier)
{
    if (null == baseInkAnalyzer)
    {
        throw new ArgumentNullException("baseInkAnalyzer");
    }

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

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

    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.