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

项目
11/04/2008

将单个笔画的笔画数据添加到墨迹分析器，并将活动输入线程的区域性标识符分配给该笔画。

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

语法

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

参数

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

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

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

返回值

类型：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.
''' </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;
}