InkAnalyzerBase.AddStrokeToCustomRecognizer-Methode
Fügt einem Knoten eines benutzerdefinierten Erkennungsmoduls Strichdaten für einen einzelnen Strich hinzu.
Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)
Syntax
'Declaration
Public Function AddStrokeToCustomRecognizer ( _
strokeId As Integer, _
strokePacketData As Integer(), _
strokePacketDescription As Guid(), _
customRecognizer As ContextNodeBase _
) As ContextNodeBase
'Usage
Dim instance As InkAnalyzerBase
Dim strokeId As Integer
Dim strokePacketData As Integer()
Dim strokePacketDescription As Guid()
Dim customRecognizer As ContextNodeBase
Dim returnValue As ContextNodeBase
returnValue = instance.AddStrokeToCustomRecognizer(strokeId, _
strokePacketData, strokePacketDescription, _
customRecognizer)
public ContextNodeBase AddStrokeToCustomRecognizer(
int strokeId,
int[] strokePacketData,
Guid[] strokePacketDescription,
ContextNodeBase customRecognizer
)
public:
ContextNodeBase^ AddStrokeToCustomRecognizer(
int strokeId,
array<int>^ strokePacketData,
array<Guid>^ strokePacketDescription,
ContextNodeBase^ customRecognizer
)
public ContextNodeBase AddStrokeToCustomRecognizer(
int strokeId,
int[] strokePacketData,
Guid[] strokePacketDescription,
ContextNodeBase customRecognizer
)
public function AddStrokeToCustomRecognizer(
strokeId : int,
strokePacketData : int[],
strokePacketDescription : Guid[],
customRecognizer : ContextNodeBase
) : 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.
- customRecognizer
Typ: System.Windows.Ink.AnalysisCore.ContextNodeBase
Der Knoten des benutzerdefinierten Erkennungsmoduls, dem der Strich hinzugefügt wird.
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.
Während der Analyse weist das Freihandanalysemodul dem Strich den Kulturbezeichner des aktiven Eingabethreads zu und fügt den Strich dem ersten nicht klassifizierten Freihandknoten unter dem Freihanderkennungsmodul hinzu. Wenn kein nicht klassifizierter Knoten vorhanden ist, wird ein solcher erstellt. Wenn das benutzerdefinierte Erkennungsmodul den Kulturbezeichner nicht unterstützt, setzt das Freihandanalysemodul die Analyse fort und generiert eine AnalysisWarningBase-Warnung. Für diese Warnung wurde die WarningCode-Eigenschaft auf den AnalysisWarningCode-Wert von LanguageIdNotRespected festgelegt.
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.
InkAnalyzerBase löst unter den folgenden Bedingungen eine Ausnahme aus.
InkAnalyzerBase enthält bereits einen Strich mit demselben Bezeichner wie der hinzuzufügende Strich.
Der customRecognizer-Parameter enthält einen ContextNodeBase, der einem anderen InkAnalyzerBase-Objekt zugeordnet ist.
Der customRecognizer-Parameter enthält einen ContextNodeBase, dessen Type-Eigenschaftswert nicht CustomRecognizer() lautet.
Beispiele
In diesem Beispiel wird eine Methode definiert, die einen Stroke in Paketdaten umwandelt und den Strich dem Knoten eines benutzerdefinierten Erkennungsmoduls hinzufügt. Die Methode gibt die ContextNodeBase zurück, der das Freihandanalysemodul den Strich hinzugefügt hat.
''' <summary>
''' Adds a stroke to a custom recognizer node.
''' </summary>
''' <param name="baseInkAnalyzer">The ink analyzer that contains the
''' custom recognizer node.</param>
''' <param name="theStroke">The stroke to add.</param>
''' <param name="theCustomRecognizer">The custom recognizer node
''' to which to add 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 MyAddStrokeToCustomRecognizer( _
ByVal baseInkAnalyzer As System.Windows.Ink.AnalysisCore.InkAnalyzerBase, _
ByVal theStroke As Microsoft.Ink.Stroke, _
ByVal theCustomRecognizer As System.Windows.Ink.AnalysisCore.ContextNodeBase) _
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
If theCustomRecognizer Is Nothing Then
Throw New ArgumentNullException("theCustomRecognizer")
End If
If System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.CustomRecognizer <> _
theCustomRecognizer.Type Then
Throw New ArgumentException( _
"The context node is not a custom recognizer node.", _
"theCustomRecognizer")
End If
If baseInkAnalyzer.FindNode(theCustomRecognizer.Id) Is Nothing Then
Throw New ArgumentException( _
"The custom recognizer node is not attached to the ink analyzer.")
End If
Dim result As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
baseInkAnalyzer.AddStrokeToCustomRecognizer(theStroke.Id, _
theStroke.GetPacketData(), theStroke.PacketDescription, _
theCustomRecognizer)
Return result
End Function 'AddStrokeToCustomRecognizer
/// <summary>
/// Adds a stroke to a custom recognizer node.
/// </summary>
/// <param name="baseInkAnalyzer">The ink analyzer that contains the
/// custom recognizer node.</param>
/// <param name="theStroke">The stroke to add.</param>
/// <param name="theCustomRecognizerNode">The custom recognizer node
/// to which to add 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 MyAddStrokeToCustomRecognizer(
System.Windows.Ink.AnalysisCore.InkAnalyzerBase baseInkAnalyzer,
Microsoft.Ink.Stroke theStroke,
System.Windows.Ink.AnalysisCore.ContextNodeBase theCustomRecognizer)
{
if (null == baseInkAnalyzer)
{
throw new ArgumentNullException("baseInkAnalyzer");
}
if (null == theStroke)
{
throw new ArgumentNullException("theStroke");
}
if (null == theCustomRecognizer)
{
throw new ArgumentNullException("theCustomRecognizer");
}
if (System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.CustomRecognizer
!= theCustomRecognizer.Type)
{
throw new ArgumentException(
"The context node is not a custom recognizer node.",
"theCustomRecognizer");
}
if (null == baseInkAnalyzer.FindNode(theCustomRecognizer.Id))
{
throw new ArgumentException(
"The custom recognizer node is not attached to the ink analyzer.");
}
System.Windows.Ink.AnalysisCore.ContextNodeBase result =
baseInkAnalyzer.AddStrokeToCustomRecognizer(
theStroke.Id, theStroke.GetPacketData(),
theStroke.PacketDescription, theCustomRecognizer);
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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0