InkAnalyzerBase.ContextNodeCreatedBase-Ereignis
Tritt auf, nachdem das Freihandanalysemodul einen ContextNodeBase erstellt hat.
Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)
Syntax
'Declaration
Public Event ContextNodeCreatedBase As ContextNodeCreatedBaseEventHandler
'Usage
Dim instance As InkAnalyzerBase
Dim handler As ContextNodeCreatedBaseEventHandler
AddHandler instance.ContextNodeCreatedBase, handler
public event ContextNodeCreatedBaseEventHandler ContextNodeCreatedBase
public:
event ContextNodeCreatedBaseEventHandler^ ContextNodeCreatedBase {
void add (ContextNodeCreatedBaseEventHandler^ value);
void remove (ContextNodeCreatedBaseEventHandler^ value);
}
/** @event */
public void add_ContextNodeCreatedBase (ContextNodeCreatedBaseEventHandler value)
/** @event */
public void remove_ContextNodeCreatedBase (ContextNodeCreatedBaseEventHandler value)
JScript unterstützt keine Ereignisse.
Hinweise
Verwenden Sie dieses Ereignis, wenn die Anwendung eine eigene Datenstruktur verwaltet, die mit der Datenstruktur von InkAnalyzerBase synchronisiert wird. Dieses Ereignis tritt während der Abgleichphase der Freihandanalyse oder als Antwort auf eine Freihandanalysemethode auf, die einen ContextNodeBase erstellt.
Wenn das Freihandanalysemodul einen Kontextknoten erstellt, enthält der neue Kontextknoten keine Striche und keine Links zu anderen Kontextknoten. Zudem sind möglicherweise nicht alle seine Eigenschaften festgelegt. Außerdem wird der neue Kontextknoten am Ende der SubNodes-Auflistung seines übergeordneten Elements hinzugefügt. Nach diesem Ereignis löst das Freihandanalysemodul möglicherweise folgende weitere Ereignisse aus.
Das StrokesReparentedBase-Ereignis beim Verschieben eines Strichs von einem Kontextknoten zu einem anderen.
Das ContextNodeLinkAddingBase-Ereignis beim Hinzufügen eines ContextLinkBase zu einem Kontextknoten.
Das ContextNodeMovingToPositionBase-Ereignis beim Ändern der Reihenfolge eines Kontextknotens in der SubNodes-Auflistung seines übergeordneten Knotens.
Das Freihandanalysemodul löst das ContextNodePropertiesUpdatedBase-Ereignis aus, nachdem es den Zustand des Kontextknotens für diese Analysephase aufgelöst hat.
Weitere Informationen zum Synchronisieren von Anwendungsdaten mit InkAnalyzerBase finden Sie unter Data Proxy with Ink Analysis.
Beispiele
Im folgenden Beispiel wird die Methode AttachDataProxyEventHandlers definiert, die Datenproxyereignishandler an die InkAnalyzerBasebaseInkAnalyzer anfügt.
Private Sub AttachDataProxyEventHandlers()
' If the document model supports on demand data proxy, then add an
' event handler for the PopulateContextNodeBase event. This event is raised
' when the InkAnalyzerBase accesses a partially populated ContextNodeBase
' created by the document model.
If Me.baseDocumentModel.SupportsOnDemandDataProxy Then
AddHandler Me.baseInkAnalyzer.PopulateContextNodeBase, AddressOf Me.PopulateContextNodeBase
End If
' Add the other data proxy related event handlers. These events are raised
' by the InkAnalyzer to communicate parsing results to the document model.
AddHandler Me.baseInkAnalyzer.ContextNodeCreatedBase, _
AddressOf Me.AddContextNodeBase
AddHandler Me.baseInkAnalyzer.ContextNodeDeletingBase, _
AddressOf Me.RemoveContextNodeBase
AddHandler Me.baseInkAnalyzer.ContextNodeLinkAddingBase, _
AddressOf Me.AddContextNodeLinkBase
AddHandler Me.baseInkAnalyzer.ContextNodeLinkDeletingBase, _
AddressOf Me.RemoveContextNodeLinkBase
AddHandler Me.baseInkAnalyzer.ContextNodeMovingToPositionBase, _
AddressOf Me.MoveContextNodeBaseToPosition
AddHandler Me.baseInkAnalyzer.ContextNodePropertiesUpdatedBase, _
AddressOf Me.UpdateContextNodeBaseProperties
AddHandler Me.baseInkAnalyzer.ContextNodeReparentingBase, _
AddressOf Me.ReparentContextNodeBase
AddHandler Me.baseInkAnalyzer.InkAnalyzerStateChangingBase, _
AddressOf Me.InkAnalyzerBase_StateChanging
AddHandler Me.baseInkAnalyzer.StrokesReparentedBase, _
AddressOf Me.ReparentStroke
AddHandler Me.baseInkAnalyzer.IntermediateResultsUpdatedBase, _
AddressOf Me.BaseResultsAvailable
AddHandler Me.baseInkAnalyzer.ResultsUpdatedBase, _
AddressOf Me.BaseResultsAvailable
End Sub 'AttachDataProxyEventHandlers
private void AttachDataProxyEventHandlers()
{
// If the document model supports on demand data proxy, then add an
// event handler for the PopulateContextNodeBase event. This event is raised
// when the InkAnalyzerBase accesses a partially populated ContextNodeBase
// created by the document model.
if (this.baseDocumentModel.SupportsOnDemandDataProxy)
{
this.baseInkAnalyzer.PopulateContextNodeBase +=
new System.Windows.Ink.AnalysisCore.PopulateContextNodeBaseEventHandler(
this.PopulateContextNodeBase);
}
// Add the other data proxy related event handlers. These events are raised
// by the InkAnalyzer to communicate parsing results to the document model.
this.baseInkAnalyzer.ContextNodeCreatedBase +=
new System.Windows.Ink.AnalysisCore.ContextNodeCreatedBaseEventHandler(
this.AddContextNodeBase);
this.baseInkAnalyzer.ContextNodeDeletingBase +=
new System.Windows.Ink.AnalysisCore.ContextNodeDeletingBaseEventHandler(
this.RemoveContextNodeBase);
this.baseInkAnalyzer.ContextNodeLinkAddingBase +=
new System.Windows.Ink.AnalysisCore.ContextNodeLinkAddingBaseEventHandler(
this.AddContextNodeLinkBase);
this.baseInkAnalyzer.ContextNodeLinkDeletingBase +=
new System.Windows.Ink.AnalysisCore.ContextNodeLinkDeletingBaseEventHandler(
this.RemoveContextNodeLinkBase);
this.baseInkAnalyzer.ContextNodeMovingToPositionBase +=
new System.Windows.Ink.AnalysisCore.ContextNodeMovingToPositionBaseEventHandler(
this.MoveContextNodeBaseToPosition);
this.baseInkAnalyzer.ContextNodePropertiesUpdatedBase +=
new System.Windows.Ink.AnalysisCore.ContextNodePropertiesUpdatedBaseEventHandler(
this.UpdateContextNodeBaseProperties);
this.baseInkAnalyzer.ContextNodeReparentingBase +=
new System.Windows.Ink.AnalysisCore.ContextNodeReparentingBaseEventHandler(
this.ReparentContextNodeBase);
this.baseInkAnalyzer.InkAnalyzerStateChangingBase +=
new System.Windows.Ink.AnalysisCore.InkAnalyzerStateChangingBaseEventHandler(
this.InkAnalyzerBase_StateChanging);
this.baseInkAnalyzer.StrokesReparentedBase +=
new System.Windows.Ink.AnalysisCore.StrokesReparentedBaseEventHandler(
this.ReparentStroke);
this.baseInkAnalyzer.IntermediateResultsUpdatedBase +=
new System.Windows.Ink.AnalysisCore.ResultsUpdatedBaseEventHandler(
this.BaseResultsAvailable);
this.baseInkAnalyzer.ResultsUpdatedBase +=
new System.Windows.Ink.AnalysisCore.ResultsUpdatedBaseEventHandler(
this.BaseResultsAvailable);
}
Im folgenden Beispiel wird die Methode AddContextNodeBase definiert, die das ContextNodeCreatedBase-Ereignis behandelt. Die Ereignisinformationen werden an das Dokumentmodellobjekt baseDocumentModel übergeben.
Dieses Beispiel liefert nicht die Definition des Dokumentmodells und veranschaulicht nicht, wie die übergebenen Informationen verarbeitet werden.
''' <summary>
''' Handles the InkAnalyzerBase.ContextNodeCreatedBase event.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
''' <remarks>
''' Note: when this event is fired, the ContextNodeBase has not been populated
''' with extended and other properties. Handle the ContextNodePropertiesUpdatedBase
''' event to populate the corresponding ContextNodeBase in the document model.
''' </remarks>
Private Sub AddContextNodeBase( _
ByVal sender As Object, _
ByVal e As System.Windows.Ink.AnalysisCore.ContextNodeCreatedBaseEventArgs)
' Do not add unclassified ink nodes to the document model.
If System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.UnclassifiedInk <> e.NodeCreated.Type Then
Me.baseDocumentModel.AddNode(e.NodeCreated)
End If
End Sub 'AddContextNodeBase
/// <summary>
/// Handles the InkAnalyzerBase.ContextNodeCreatedBase event.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
/// <remarks>
/// Note: when this event is fired, the ContextNodeBase has not been populated
/// with extended and other properties. Handle the ContextNodePropertiesUpdatedBase
/// event to populate the corresponding ContextNodeBase in the document model.
/// </remarks>
private void AddContextNodeBase(
object sender, System.Windows.Ink.AnalysisCore.ContextNodeCreatedBaseEventArgs e)
{
// Do not add unclassified ink nodes to the document model.
if (System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.UnclassifiedInk
!= e.NodeCreated.Type)
{
this.baseDocumentModel.AddNode(e.NodeCreated);
}
}
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
Siehe auch
Referenz
System.Windows.Ink.AnalysisCore-Namespace
InkAnalyzerBase.ContextNodeDeletingBase
InkAnalyzerBase.ContextNodeLinkAddingBase
InkAnalyzerBase.ContextNodeMovingToPositionBase