InkAnalyzerBase.ContextNodeCreatedBase, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit une fois que l'analyseur d'entrée manuscrite a créé un ContextNodeBase.

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

Syntaxe

'Déclaration
Public Event ContextNodeCreatedBase As ContextNodeCreatedBaseEventHandler
'Utilisation
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 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. Cet événement se produit pendant la phase de rapprochement de l'analyse d'entrée manuscrite ou lorsqu'une méthode d'analyse d'entrée manuscrite a créé un ContextNodeBase.

Lorsque l'analyseur d'entrée manuscrite crée un nœud de contexte, ce dernier ne contient pas de traits ou de liens vers d'autres nœuds de contexte et ses propriétés ne sont pas nécessairement toutes définies. De plus, le nouveau nœud de contexte est ajouté à la fin de la collection SubNodes de son parent. Après cet événement, l'analyseur d'entrée manuscrite peut déclencher les événements suivants.

L'événement StrokesReparentedBase lorsqu'il déplace un trait d'un nœud de contexte vers un autre.
L'événement ContextNodeLinkAddingBase lorsqu'il ajoute un ContextLinkBase à un nœud de contexte.
L'événement ContextNodeMovingToPositionBase lorsqu'il modifie l'ordre d'un nœud de contexte dans la collection SubNodes de son nœud parent.
L'analyseur d'entrée manuscrite déclenche l'événement ContextNodePropertiesUpdatedBase après la résolution de l'état du nœud de contexte pour cette phase d'analyse.

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

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 une méthode, AddContextNodeBase, qui gère l'événement ContextNodeCreatedBase. 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.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);
            }
        }

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.