InkAnalyzer.PopulateContextNode-Ereignis
Tritt auf, bevor der InkAnalyzer die Analyse innerhalb des Bereichs eines teilweise aufgefüllten ContextNode ausführt.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Syntax
'Declaration
Public Event PopulateContextNode As PopulateContextNodeEventHandler
'Usage
Dim instance As InkAnalyzer
Dim handler As PopulateContextNodeEventHandler
AddHandler instance.PopulateContextNode, handler
public event PopulateContextNodeEventHandler PopulateContextNode
public:
event PopulateContextNodeEventHandler^ PopulateContextNode {
void add (PopulateContextNodeEventHandler^ value);
void remove (PopulateContextNodeEventHandler^ value);
}
/** @event */
public void add_PopulateContextNode (PopulateContextNodeEventHandler value)
/** @event */
public void remove_PopulateContextNode (PopulateContextNodeEventHandler value)
JScript unterstützt keine Ereignisse.
Hinweise
Verwenden Sie dieses Ereignis, wenn die Anwendung eine eigene Datenstruktur verwaltet, die mit der Datenstruktur von InkAnalyzer synchronisiert wird. Wenn InkAnalyzer dieses Ereignis auslöst, sollte die Anwendung den PopulateContextNodeEventArgs.NodeToPopulate auffüllen. Während der Analysephase löst der InkAnalyzer dieses Ereignis aus, um Informationen für die Bereiche abzurufen, in denen Freihandeingaben zu analysieren sind.
Wenn das Dokument Links zu NodeToPopulate enthält, sollte die Anwendung diese Links erstellen und hinzufügen. Dieser Prozess erfordert es, dass sowohl der Quell- als auch der Zielknoten, einschließlich ihrer Vorgänger, vollständig aufgefüllt sind, bevor der Ereignishandler für dieses Ereignis existiert.
Weitere Informationen über das Synchronisieren von Anwendungsdaten mit InkAnalyzer finden Sie unter Data Proxy with Ink Analysis.
Während der Hintergrundanalyse löst der InkAnalyzer dieses Ereignis aus, nachdem er das InkAnalyzerStateChanging-Ereignis ausgelöst hat.
Beispiele
In diesem Beispiel wird eine Methode mit dem Namen AttachDataProxyEventHandlers definiert, die Datenproxyereignishandler an einen InkAnalyzer mit dem Namen theInkAnalyzer anfügt.
Private Sub AttachDataProxyEventHandlers()
' If the document model supports on demand data proxy, then add an
' event handler for the PopulateContextNode event. This event is raised
' when the InkAnalyzer accesses a partially populated ContextNode created
' by the document model.
If Me.theDocumentModel.SupportsOnDemandDataProxy Then
AddHandler Me.theInkAnalyzer.PopulateContextNode, AddressOf Me.PopulateContextNode
End If
' Add the other data proxy related event handlers. These events are raised
' by the InkAnalyzer to communicate ink analysis results to the document model.
AddHandler Me.theInkAnalyzer.ContextNodeCreated, AddressOf Me.AddContextNode
AddHandler Me.theInkAnalyzer.ContextNodeDeleting, AddressOf Me.RemoveContextNode
AddHandler Me.theInkAnalyzer.ContextNodeLinkAdding, AddressOf Me.AddContextNodeLink
AddHandler Me.theInkAnalyzer.ContextNodeLinkDeleting, AddressOf Me.RemoveContextNodeLink
AddHandler Me.theInkAnalyzer.ContextNodeMovingToPosition, AddressOf Me.MoveContextNodeToPosition
AddHandler Me.theInkAnalyzer.ContextNodePropertiesUpdated, AddressOf Me.UpdateContextNodeProperties
AddHandler Me.theInkAnalyzer.ContextNodeReparenting, AddressOf Me.ReparentContextNode
AddHandler Me.theInkAnalyzer.InkAnalyzerStateChanging, AddressOf Me.InkAnalyzer_StateChanging
AddHandler Me.theInkAnalyzer.StrokesReparented, AddressOf Me.ReparentStroke
AddHandler Me.theInkAnalyzer.IntermediateResultsUpdated, AddressOf Me.ResultsAvailable
AddHandler Me.theInkAnalyzer.ResultsUpdated, AddressOf Me.ResultsAvailable
End Sub 'AttachDataProxyEventHandlers
private void AttachDataProxyEventHandlers()
{
// If the document model supports on demand data proxy, then add an
// event handler for the PopulateContextNode event. This event is raised
// when the InkAnalyzer accesses a partially populated ContextNode created
// by the document model.
if (this.theDocumentModel.SupportsOnDemandDataProxy)
{
this.theInkAnalyzer.PopulateContextNode +=
new Microsoft.Ink.PopulateContextNodeEventHandler(
this.PopulateContextNode);
}
// Add the other data proxy related event handlers. These events are raised
// by the InkAnalyzer to communicate ink analysis results to the document model.
this.theInkAnalyzer.ContextNodeCreated +=
new Microsoft.Ink.ContextNodeCreatedEventHandler(
this.AddContextNode);
this.theInkAnalyzer.ContextNodeDeleting +=
new Microsoft.Ink.ContextNodeDeletingEventHandler(
this.RemoveContextNode);
this.theInkAnalyzer.ContextNodeLinkAdding +=
new Microsoft.Ink.ContextNodeLinkAddingEventHandler(
this.AddContextNodeLink);
this.theInkAnalyzer.ContextNodeLinkDeleting +=
new Microsoft.Ink.ContextNodeLinkDeletingEventHandler(
this.RemoveContextNodeLink);
this.theInkAnalyzer.ContextNodeMovingToPosition +=
new Microsoft.Ink.ContextNodeMovingToPositionEventHandler(
this.MoveContextNodeToPosition);
this.theInkAnalyzer.ContextNodePropertiesUpdated +=
new Microsoft.Ink.ContextNodePropertiesUpdatedEventHandler(
this.UpdateContextNodeProperties);
this.theInkAnalyzer.ContextNodeReparenting +=
new Microsoft.Ink.ContextNodeReparentingEventHandler(
this.ReparentContextNode);
this.theInkAnalyzer.InkAnalyzerStateChanging +=
new Microsoft.Ink.InkAnalyzerStateChangingEventHandler(
this.InkAnalyzer_StateChanging);
this.theInkAnalyzer.StrokesReparented +=
new Microsoft.Ink.StrokesReparentedEventHandler(
this.ReparentStrokes);
this.theInkAnalyzer.IntermediateResultsUpdated +=
new Microsoft.Ink.ResultsUpdatedEventHandler(
this.ResultsAvailable);
this.theInkAnalyzer.ResultsUpdated +=
new Microsoft.Ink.ResultsUpdatedEventHandler(
this.ResultsAvailable);
}
Im folgenden Beispiel wird die PopulateContextNode-Methode definiert, die das PopulateContextNode-Ereignis behandelt. Die Ereignisinformationen werden an das Dokumentmodellobjekt theDocumentModel übergeben.
Dieses Beispiel liefert nicht die Definition des Dokumentmodells und veranschaulicht nicht, wie die übergebenen Informationen verarbeitet werden.
'/ <summary>
'/ Handles the InkAnalyzer.PopulateContextNode event.
'/ </summary>
'/ <param name="sender">The source of the event.</param>
'/ <param name="e">The event data.</param>
'/ <remarks>
'/ This event handler fully populates a ContextNode from the document model.
'/ The InkAnalyzer calls this event handler when it accesses a partially
'/ populated ContextNode created by the document model.
'/ </remarks>
Private Sub PopulateContextNode( _
ByVal sender As Object, _
ByVal e As Microsoft.Ink.PopulateContextNodeEventArgs)
Me.theDocumentModel.PopulateNode(e.NodeToPopulate, _
CType(sender, Microsoft.Ink.InkAnalyzer))
End Sub 'PopulateContextNode
/// <summary>
/// Handles the InkAnalyzer.PopulateContextNode event.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
/// <remarks>
/// This event handler fully populates a ContextNode from the document model.
/// The InkAnalyzer calls this event handler when it accesses a partially
/// populated ContextNode created by the document model.
/// </remarks>
private void PopulateContextNode(
object sender, Microsoft.Ink.PopulateContextNodeEventArgs e)
{
this.theDocumentModel.PopulateNode(
e.NodeToPopulate, (Microsoft.Ink.InkAnalyzer)sender);
}
Plattformen
Windows Vista
.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