InkAnalyzerBase.PopulateContextNodeBase, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit avant que l'analyseur d'entrée manuscrite effectue une analyse dans la région d'un ContextNodeBase partiellement rempli.

Espace de noms : System.Windows.Ink.AnalysisCore
Assembly : IACore (dans IACore.dll)

Syntaxe

'Déclaration
Public Event PopulateContextNodeBase As PopulateContextNodeBaseEventHandler
'Utilisation
Dim instance As InkAnalyzerBase
Dim handler As PopulateContextNodeBaseEventHandler

AddHandler instance.PopulateContextNodeBase, handler

public event PopulateContextNodeBaseEventHandler PopulateContextNodeBase

public:
 event PopulateContextNodeBaseEventHandler^ PopulateContextNodeBase {
    void add (PopulateContextNodeBaseEventHandler^ value);
    void remove (PopulateContextNodeBaseEventHandler^ value);
}

/** @event */
public void add_PopulateContextNodeBase (PopulateContextNodeBaseEventHandler value)
/** @event */
public void remove_PopulateContextNodeBase (PopulateContextNodeBaseEventHandler value)

JScript ne prend pas en charge les événements.

Notes

Utilisez cet événement lorsque votre application gère sa propre structure de données, synchronisée avec celle de InkAnalyzerBase. Lorsque l'analyseur d'entrée manuscrite déclenche cet événement, votre application doit remplir la propriété PopulateContextNodeBaseEventArgs.NodeToPopulate. Pendant la phase d'analyse, l'analyseur d'entrée manuscrite déclenche cet événement pour obtenir des informations pour les zones dans lesquelles il analyse l'entrée manuscrite.

Si le document contient des liens pour la propriété NodeToPopulate, votre application doit créer et ajouter ces liens. Ce processus requiert le remplissage complet des nœuds source et de destination, y compris de leurs ancêtres, avant que le gestionnaire d'événements de cet événement puisse se fermer.

Pour plus d'informations sur la synchronisation des données d'application avec le InkAnalyzerBase, consultez Data Proxy with Ink Analysis.

Pendant l'analyse d'arrière-plan, l'analyseur d'entrée manuscrite déclenche cet événement après le déclenchement de l'événement ReadyToReconcileBase.

Exemples

L'exemple suivant définit une méthode, AttachDataProxyEventHandlers, qui attache des gestionnaires d'événements de proxy de données à un InkAnalyzerBase, baseInkAnalyzer.

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);
        }

L'exemple suivant définit la méthode PopulateContextNodeBase, qui gère l'événement PopulateContextNodeBase. Les informations sur l'événement sont passées à l'objet de modèle de document, baseDocumentModel.

Cet exemple ne fournit pas la définition du modèle de document et ne montre pas comment traiter les informations qui lui sont passées.

''' <summary>
''' Handles the InkAnalyzerBase.PopulateContextNodeBase 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 ContextNodeBase from the document model.
''' The InkAnalyzerBase calls this event handler when it accesses a partially
''' populated ContextNodeBase created by the document model.
''' </remarks>
Private Sub PopulateContextNodeBase( _
    ByVal sender As Object, _
    ByVal e As System.Windows.Ink.AnalysisCore.PopulateContextNodeBaseEventArgs)

    Me.baseDocumentModel.PopulateNode( _
        e.NodeToPopulate, CType(sender, System.Windows.Ink.AnalysisCore.InkAnalyzerBase))

End Sub 'PopulateContextNodeBase

        /// <summary>
        /// Handles the InkAnalyzerBase.PopulateContextNodeBase 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 ContextNodeBase from the document model.
        /// The InkAnalyzerBase calls this event handler when it accesses a partially
        /// populated ContextNodeBase created by the document model.
        /// </remarks>
        private void PopulateContextNodeBase(
            object sender, System.Windows.Ink.AnalysisCore.PopulateContextNodeBaseEventArgs e)
        {
            this.baseDocumentModel.PopulateNode(
                e.NodeToPopulate,
                (System.Windows.Ink.AnalysisCore.InkAnalyzerBase)sender);
        }

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.