InkAnalyzerBase.PopulateContextNodeBase (Evento)

Artículo
11/26/2008

Actualización: noviembre 2007

Se produce antes de que el analizador de entrada manuscrita realice el análisis en la región de un objeto ContextNodeBase parcialmente lleno.

Espacio de nombres: System.Windows.Ink.AnalysisCore
Ensamblado: IACore (en IACore.dll)

Sintaxis

'Declaración
Public Event PopulateContextNodeBase As PopulateContextNodeBaseEventHandler
'Uso
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 no admite eventos.

Comentarios

Utilice este evento cuando la aplicación mantenga su propia estructura de datos, que está sincronizada con la del objeto InkAnalyzerBase. Cuando el analizador de entrada manuscrita provoca este evento, la aplicación debería llenar la propiedad PopulateContextNodeBaseEventArgs.NodeToPopulate. Durante la fase de análisis, el analizador de entrada manuscrita provoca este evento para obtener información sobre las áreas en las que está analizando la entrada manuscrita.

Si el documento contiene vínculos de la propiedad NodeToPopulate, la aplicación debería crear y agregar estos vínculos. Este proceso requiere que los nodos de origen y destino, incluso sus antecesores, estén totalmente rellenos antes de que se cierre el controlador de este evento.

Para obtener más información sobre la sincronización entre los datos de la aplicación y InkAnalyzerBase, vea Data Proxy with Ink Analysis.

Durante el análisis en segundo plano, el analizador de entrada manuscrita provoca este evento después de provocar el evento ReadyToReconcileBase.

Ejemplos

En el ejemplo siguiente se define un método, AttachDataProxyEventHandlers, que asocia los controladores de eventos del proxy de datos a un objeto 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);
        }

En el ejemplo siguiente se define el método, PopulateContextNodeBase, que controla el evento PopulateContextNodeBase. La información del evento se pasa al objeto del modelo de documento, baseDocumentModel.

En este ejemplo no se proporciona la definición del modelo de documento ni se muestra cómo procesa la información que se le pasa.

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

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.