InkAnalyzerBase.AddStroke (Método) (Int32, array<Int32[], array<Guid[], Int32)

Artículo
11/26/2008

Actualización: noviembre 2007

Agrega datos de trazo para un trazo único al analizador de entrada manuscrita y asigna al trazo un identificador de referencia cultural concreto.

Espacio de nombres: System.Windows.Ink.AnalysisCore
Ensamblado: IACore (en IACore.dll)

Sintaxis

'Declaración
Public Function AddStroke ( _
    strokeId As Integer, _
    strokePacketData As Integer(), _
    strokePacketDescription As Guid(), _
    languageId As Integer _
) As ContextNodeBase
'Uso
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

Parámetros

strokeId
Tipo: System.Int32
Identificador del trazo.

strokePacketData
Tipo: array<System.Int32[]
Matriz que contiene los datos del paquete del trazo.

strokePacketDescription
Tipo: array<System.Guid[]
Matriz que contiene los identificadores de las propiedades del paquete.

languageId
Tipo: System.Int32
Identificador de referencia cultural que se asigna al trazo.

Valor devuelto

Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBase
Nodo de contexto al que el analizador de entrada manuscrita agregó el trazo.

Comentarios

InkAnalyzerBase agrega el trazo a un objeto ContextNodeBase cuya propiedad Type tiene el valor UnclassifiedInk().

El analizador de entrada manuscrita asigna el identificador de referencia cultural especificado al trazo. Después, agrega el trazo al primer nodo de entrada manuscrita no clasificado que está situado bajo el nodo raíz del analizador de entrada manuscrita que contiene trazos con el mismo identificador de referencia cultural. Si el analizador de entrada manuscrita no encuentra un nodo con el mismo identificador de referencia cultural, crea un nuevo objeto ContextNodeBase bajo su nodo raíz y agrega el trazo al nuevo nodo de entrada manuscrita no clasificado.

strokePacketData contiene datos del paquete de todos los puntos del trazo. strokePacketDescription contiene los identificadores únicos globales (GUID) que describen los tipos de datos del paquete incluidos para cada punto del trazo. Para obtener una lista completa de las propiedades del paquete disponibles, vea la clase PacketProperty.

Este método expande la propiedad DirtyRegion a la unión del valor actual de la región y el cuadro de límite del trazo agregado.

Si InkAnalyzerBase ya contiene un trazo con el mismo identificador, InkAnalyzerBase inicia una excepción.

Ejemplos

En este ejemplo, se define un método que convierte Stroke en datos de paquete, agrega el trazo a un objeto InkAnalyzerBase y asigna un identificador de configuración regional concreto al trazo. El método devuelve el objeto ContextNodeBase al que el analizador de entrada manuscrita agregó el trazo.

''' <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;
}

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.