Evento InkAnalyzer.PopulateContextNode
Aggiornamento: novembre 2007
Si verifica prima che InkAnalyzer esegue l'analisi all'interno dell'area di un oggetto ContextNode parzialmente compilato.
Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Sintassi
'Dichiarazione
Public Event PopulateContextNode As PopulateContextNodeEventHandler
'Utilizzo
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 non supporta gli eventi.
Note
Utilizzare questo evento nel caso in cui l'applicazione gestisce una struttura di dati personalizzata, sincronizzata con quella dell'oggetto InkAnalyzer. Quando l'oggetto InkAnalyzer genera questo evento, l'applicazione deve compilare la proprietà PopulateContextNodeEventArgs.NodeToPopulate. Durante la fase di analisi, l'oggetto InkAnalyzer genera questo evento per ottenere le informazioni sulle aree in cui sta eseguendo l'analisi dell'input penna.
Se il documento contiene collegamenti per la proprietà NodeToPopulate, l'applicazione deve creare e deve aggiungere questi collegamenti. Questo processo richiede che i nodi di origine e di destinazione, inclusi i relativi predecessori, siano completamente compilati prima dell'uscita del gestore eventi di questo evento.
Per ulteriori informazioni sulla sincronizzazione dei dati applicazioni con InkAnalyzer, vedere Data Proxy with Ink Analysis.
Durante l'analisi in background, InkAnalyzer genera questo evento dopo aver generato l'evento InkAnalyzerStateChanging.
Esempi
In questo esempio viene definito un metodo, AttachDataProxyEventHandlers, che associa i gestori eventi del proxy di dati a un oggetto InkAnalyzer, theInkAnalyzer.
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);
}
Nell'esempio seguente viene definito il metodo, PopulateContextNode, che gestisce l'evento PopulateContextNode. Le informazioni relative all’evento vengono passate all’oggetto modello di documento, theDocumentModel.
In questo esempio non viene fornita la definizione del modello di documento né viene illustrato come vengono elaborate le informazioni passate a tale modello.
'/ <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);
}
Piattaforme
Windows Vista
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Informazioni sulla versione
.NET Framework
Supportato in: 3.0