將多個筆劃的筆劃資料加入至自訂辨識器節點。
命名空間： System.Windows.Ink.AnalysisCore
組件： IACore (在 IACore.dll 中)
語法
'宣告
Public Function AddStrokesToCustomRecognizer ( _
strokeIds As Integer(), _
strokePacketCount As Integer(), _
strokePacketData As Integer(), _
strokePacketDescription As Guid(), _
customRecognizer As ContextNodeBase _
) As ContextNodeBase
'用途
Dim instance As InkAnalyzerBase
Dim strokeIds As Integer()
Dim strokePacketCount As Integer()
Dim strokePacketData As Integer()
Dim strokePacketDescription As Guid()
Dim customRecognizer As ContextNodeBase
Dim returnValue As ContextNodeBase
returnValue = instance.AddStrokesToCustomRecognizer(strokeIds, _
strokePacketCount, strokePacketData, _
strokePacketDescription, customRecognizer)
public ContextNodeBase AddStrokesToCustomRecognizer(
int[] strokeIds,
int[] strokePacketCount,
int[] strokePacketData,
Guid[] strokePacketDescription,
ContextNodeBase customRecognizer
)
public:
ContextNodeBase^ AddStrokesToCustomRecognizer(
array<int>^ strokeIds,
array<int>^ strokePacketCount,
array<int>^ strokePacketData,
array<Guid>^ strokePacketDescription,
ContextNodeBase^ customRecognizer
)
public ContextNodeBase AddStrokesToCustomRecognizer(
int[] strokeIds,
int[] strokePacketCount,
int[] strokePacketData,
Guid[] strokePacketDescription,
ContextNodeBase customRecognizer
)
public function AddStrokesToCustomRecognizer(
strokeIds : int[],
strokePacketCount : int[],
strokePacketData : int[],
strokePacketDescription : Guid[],
customRecognizer : ContextNodeBase
) : ContextNodeBase
參數
- strokeIds
型別：array<System.Int32[]
陣列，包含筆劃識別項。
- strokePacketCount
型別：array<System.Int32[]
陣列，包含每個筆劃中的封包數目。
- strokePacketData
型別：array<System.Int32[]
陣列，包含筆劃的封包資料。
- strokePacketDescription
型別：array<System.Guid[]
陣列，包含封包屬性識別項。
- customRecognizer
型別：System.Windows.Ink.AnalysisCore.ContextNodeBase
要在其中加入筆劃的自訂辨識器節點。
傳回值
型別：System.Windows.Ink.AnalysisCore.ContextNodeBase
筆墨分析器在其中加入筆劃的內容節點。
備註
InkAnalyzerBase 會將筆劃加入至 Type 屬性值為 UnclassifiedInk() 的 ContextNodeBase。
在分析期間，筆墨分析器會將使用中輸入執行緒的文化特性識別項指派至筆劃，並將該筆劃加入至筆墨辨識器下第一個未分類的筆墨節點。如果沒有未分類的節點，則會建立一個。如果自訂辨識器不支援文化特性識別項，則筆墨分析器會繼續分析並產生 AnalysisWarningBase 警告。這個警告的 WarningCode 屬性設為 LanguageIdNotRespected 的 AnalysisWarningCode 值。
在 AddStrokes 的單一呼叫中只能加入具有相同封包描述的筆劃。
這個方法會將 DirtyRegion 擴充至區域目前值和所加入筆劃之週框方塊的聯集。
InkAnalyzerBase 會在下列情況下擲回例外狀況。
InkAnalyzerBase 已包含之筆劃的識別項與要加入之其中一個筆劃的識別項相同。
customRecognizer 參數包含與不同 InkAnalyzerBase 物件相關聯的 ContextNodeBase。
customRecognizer 參數包含 ContextNodeBase，其 Type 屬性值不是 CustomRecognizer()。
範例
這個範例會定義將 Strokes 集合轉換成封包資料，並且將筆劃加入至自訂辨識器節點的方法。此方法會傳回筆墨分析器已將筆劃加入其中的 ContextNodeBase。
''' <summary>
''' Adds a collection of strokes to a custom recognizer node.
''' </summary>
''' <param name="baseInkAnalyzer">The ink analyzer that contains the
''' custom recognizer node.</param>
''' <param name="theStrokes">The strokes to add.</param>
''' <param name="theCustomRecognizerNode">The custom recognizer node
''' to which to add the strokes.</param>
''' <returns>The node to which the analyzer added the strokes.</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 MyAddStrokesToCustomRecognizer( _
ByVal baseInkAnalyzer As System.Windows.Ink.AnalysisCore.InkAnalyzerBase, _
ByVal theStrokes As Microsoft.Ink.Strokes, _
ByVal theCustomRecognizerNode As System.Windows.Ink.AnalysisCore.ContextNodeBase) _
As System.Windows.Ink.AnalysisCore.ContextNodeBase
If Nothing Is baseInkAnalyzer Then
Throw New ArgumentNullException("baseInkAnalyzer")
End If
If Nothing Is theStrokes Then
Throw New ArgumentNullException("theStrokes")
End If
If 0 = theStrokes.Count Then
Throw New ArgumentException("Empty strokes collection.")
End If
If System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.CustomRecognizer <> theCustomRecognizerNode.Type Then
Throw New ArgumentException("The context node is not a custom recognizer node.", "theCustomRecognizer")
End If
If Nothing Is baseInkAnalyzer.FindNode(theCustomRecognizerNode.Id) Then
Throw New ArgumentException("The custom recognizer node is not attached to the ink analyzer.")
End If
' Only strokes that have the same packet description GUIDs
' can be added in one call to InkAnalyzerBase.AddStrokes.
Dim thePacketDescription As Guid() = theStrokes(0).PacketDescription
' Accumulate the stroke data in collections.
Dim theStrokeIdentifiers As New ArrayList()
Dim thePacketCounts As New ArrayList()
Dim thePacketData As New ArrayList()
Dim aStroke As Microsoft.Ink.Stroke
For Each aStroke In theStrokes
If Not InkAnalyzerHelper.AreElementwiseEquivalent(aStroke.PacketDescription, thePacketDescription) Then
Throw New ApplicationException("The strokes collection contains strokes with different packet descriptions.")
End If
' Add the stroke data to the collections.
theStrokeIdentifiers.Add(aStroke.Id)
thePacketCounts.Add(aStroke.PacketCount)
thePacketData.AddRange(aStroke.GetPacketData())
Next aStroke
' Add the stroke data to the base layer ink analyzer.
Dim result As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
baseInkAnalyzer.AddStrokesToCustomRecognizer( _
DirectCast(theStrokeIdentifiers.ToArray(GetType(Integer)), Integer()), _
DirectCast(thePacketCounts.ToArray(GetType(Integer)), Integer()), _
DirectCast(thePacketData.ToArray(GetType(Integer)), Integer()), _
thePacketDescription, _
theCustomRecognizerNode)
Return result
End Function 'AddStrokesToCustomRecognizer
/// <summary>
/// Adds a collection of strokes to a custom recognizer node.
/// </summary>
/// <param name="baseInkAnalyzer">The ink analyzer that contains the
/// custom recognizer node.</param>
/// <param name="theStrokes">The strokes to add.</param>
/// <param name="theCustomRecognizerNode">The custom recognizer node
/// to which to add the strokes.</param>
/// <returns>The node to which the analyzer added the strokes.</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 MyAddStrokesToCustomRecognizer(
System.Windows.Ink.AnalysisCore.InkAnalyzerBase baseInkAnalyzer,
Microsoft.Ink.Strokes theStrokes,
System.Windows.Ink.AnalysisCore.ContextNodeBase theCustomRecognizerNode)
{
if (null == baseInkAnalyzer)
{
throw new ArgumentNullException("baseInkAnalyzer");
}
if (null == theStrokes)
{
throw new ArgumentNullException("theStrokes");
}
if (0 == theStrokes.Count)
{
throw new ArgumentException("Empty strokes collection.");
}
if (System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.CustomRecognizer
!= theCustomRecognizerNode.Type)
{
throw new ArgumentException(
"The context node is not a custom recognizer node.",
"theCustomRecognizer");
}
if (null == baseInkAnalyzer.FindNode(theCustomRecognizerNode.Id))
{
throw new ArgumentException(
"The custom recognizer node is not attached to the ink analyzer.");
}
// Only strokes that have the same packet description GUIDs
// can be added in one call to InkAnalyzerBase.AddStrokes.
Guid[] thePacketDescription = theStrokes[0].PacketDescription;
// Accumulate the stroke data in collections.
ArrayList theStrokeIdentifiers = new ArrayList();
ArrayList thePacketCounts = new ArrayList();
ArrayList thePacketData = new ArrayList();
foreach (Microsoft.Ink.Stroke aStroke in theStrokes)
{
if (!InkAnalyzerHelper.AreElementwiseEquivalent(
aStroke.PacketDescription, thePacketDescription))
{
throw new ApplicationException(
"The strokes collection contains strokes with different packet descriptions.");
}
// Add the stroke data to the collections.
theStrokeIdentifiers.Add(aStroke.Id);
thePacketCounts.Add(aStroke.PacketCount);
thePacketData.AddRange(aStroke.GetPacketData());
}
// Add the stroke data to the base layer ink analyzer.
System.Windows.Ink.AnalysisCore.ContextNodeBase result =
baseInkAnalyzer.AddStrokesToCustomRecognizer(
theStrokeIdentifiers.ToArray(typeof(int)) as int[],
thePacketCounts.ToArray(typeof(int)) as int[],
thePacketData.ToArray(typeof(int)) as int[],
thePacketDescription,
theCustomRecognizerNode);
return result;
}
平台
Windows Vista, Windows XP SP2, Windows Server 2003
.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。
版本資訊
.NET Framework
支援版本：3.0