InkAnalyzerBase.AddStroke 方法 (Int32, array<Int32[], array<Guid[], Int32)

项目
10/28/2008

将单个笔画的笔画数据添加到墨迹分析器，并将特定区域性标识符分配给该笔画。

命名空间： System.Windows.Ink.AnalysisCore
程序集： IACore（在 IACore.dll 中）

语法

声明
Public Function AddStroke ( _
    strokeId As Integer, _
    strokePacketData As Integer(), _
    strokePacketDescription As Guid(), _
    languageId As Integer _
) As ContextNodeBase
用法
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

参数

strokeId
类型：System.Int32
笔画标识符。

strokePacketData
类型：array<System.Int32[]
包含笔画数据包数据的数组。

strokePacketDescription
类型：array<System.Guid[]
包含数据包属性标识符的数组。

languageId
类型：System.Int32
要分配给笔画的区域性标识符。

返回值

类型：System.Windows.Ink.AnalysisCore.ContextNodeBase
墨迹分析器向其添加了笔画的上下文节点。

备注

InkAnalyzerBase 将笔画添加到 Type 属性值为 UnclassifiedInk() 的 ContextNodeBase。

墨迹分析器将指定区域性标识符分配给笔画。然后，将笔画添加到墨迹分析器的根节点之下的、包含具有相同区域性标识符的笔画的第一个未分类墨迹节点。如果墨迹分析器无法找到具有相同区域性标识符的节点，则分析器会在其根节点之下创建一个新的 ContextNodeBase，并将笔画添加到该新的未分类墨迹节点。

strokePacketData 包含笔画中所有点的数据包数据。strokePacketDescription 包含用于描述笔画中每个点所包含的数据包数据类型的全局唯一标识符 (GUID)。有关可用数据包属性的完整列表，请参见 PacketProperty 类。

此方法将 DirtyRegion 扩展为区域的当前值与所添加笔画的边界框的并集。

如果 InkAnalyzerBase 已包含具有相同标识符的笔画，则 InkAnalyzerBase 会引发异常。

示例

此示例定义一个方法，该方法将 Stroke 转换为数据包数据，然后将笔画添加到 InkAnalyzerBase，并为笔画分配一个特定的区域设置标识符。该方法返回墨迹分析器向其添加笔画的 ContextNodeBase。

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