InkAnalyzerBase.ContextNodeCreatedBase 事件

發行項
10/29/2008

在筆墨分析器建立 ContextNodeBase 之後發生。

命名空間： System.Windows.Ink.AnalysisCore
組件： IACore (在 IACore.dll 中)

語法

'宣告
Public Event ContextNodeCreatedBase As ContextNodeCreatedBaseEventHandler
'用途
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 不支援事件。

備註

當您的應用程式維護本身的資料結構時使用這個事件，該資料結構會與 InkAnalyzerBase 的資料結構同步處理。這個事件會在筆墨分析的協調階段，或是回應建立 ContextNodeBase 的筆墨分析器方法時發生。

當筆墨分析器建立內容節點時，新的內容節點不會包含任何筆劃、不會包含其他內容節點的連結，可能也不會包含其所有屬性集。同時，新的內容節點會加入至其父代 SubNodes 集合的結尾。在這個事件之後，筆墨分析器可能會引發下列事件。

將筆劃從其中一個內容節點移到另一個時，會引發 StrokesReparentedBase 事件。
將 ContextLinkBase 加入至內容節點時，會引發 ContextNodeLinkAddingBase 事件。
在父節點的 SubNodes 集合中變更內容節點的順序時，會引發 ContextNodeMovingToPositionBase 事件。
筆墨分析器會在解析這個分析階段的內容節點狀態之後，引發 ContextNodePropertiesUpdatedBase 事件。

如需將應用程式資料與 InkAnalyzerBase 進行同步處理的詳細資訊，請參閱Data Proxy with Ink Analysis。

範例

下列範例會定義 AttachDataProxyEventHandlers 方法，將資料 Proxy 事件處理常式附加至 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);
        }

下列範例會定義 AddContextNodeBase 方法，用來處理 ContextNodeCreatedBase 事件。事件資訊會傳遞至 baseDocumentModel 文件模型物件。

這個範例並未提供文件模型的定義，也未示範處理傳入資訊的方式。

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