InkAnalyzerBase.ContextNodeDeletingBase イベント

2008-10-28

インクアナライザが ContextNodeBase を削除する前に発生します。

名前空間 : System.Windows.Ink.AnalysisCore
アセンブリ : IACore (IACore.dll 内)

構文

'宣言
Public Event ContextNodeDeletingBase As ContextNodeDeletingBaseEventHandler
'使用
Dim instance As InkAnalyzerBase
Dim handler As ContextNodeDeletingBaseEventHandler

AddHandler instance.ContextNodeDeletingBase, handler

public event ContextNodeDeletingBaseEventHandler ContextNodeDeletingBase

public:
 event ContextNodeDeletingBaseEventHandler^ ContextNodeDeletingBase {
    void add (ContextNodeDeletingBaseEventHandler^ value);
    void remove (ContextNodeDeletingBaseEventHandler^ value);
}

/** @event */
public void add_ContextNodeDeletingBase (ContextNodeDeletingBaseEventHandler value)
/** @event */
public void remove_ContextNodeDeletingBase (ContextNodeDeletingBaseEventHandler value)

JScript では、イベントは使用できません。

解説

このイベントは、アプリケーションが InkAnalyzerBase のデータ構造と同期されている独自のデータ構造を保持している場合に使用します。このイベントは、インク分析の調整段階で、または ContextNodeBase を削除するインクアナライザメソッドへの応答として発生します。

インクアナライザがコンテキストノードを削除する前に、アナライザはすべてのストロークをコンテキストノードから削除し、他のコンテキストノードへのすべてのリンクを削除します。コンテキストノードが削除される前、InkAnalyzerBase は次のイベントを発生させます。

ContextNodeBase からストロークを移動した場合は、StrokesReparentedBase イベント。
ContextLinkBase をコンテキストノードから削除する前の場合は、ContextNodeLinkDeletingBase イベント。
子ノードがなくなった親コンテキストノードを削除する前の場合は、ContextNodeDeletingBase イベント。

アプリケーションデータと InkAnalyzerBase の同期の詳細については、「Data Proxy with Ink Analysis」を参照してください。

例

次の例では、データプロキシイベントハンドラを InkAnalyzerBase、baseInkAnalyzer にアタッチする AttachDataProxyEventHandlers メソッドを定義します。

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

次の例では、ContextNodeDeletingBase イベントを処理する RemoveContextNodeBase メソッドを定義します。イベント情報が、ドキュメントモデルオブジェクト baseDocumentModel に渡されます。

この例では、ドキュメントモデルを定義したり、ドキュメントモデルが渡された情報を処理する方法を示したりはしません。

''' <summary>
''' Handles the InkAnalyzerBase.ContextNodeDeletingBase event.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Private Sub RemoveContextNodeBase( _
    ByVal sender As Object, _
    ByVal e As System.Windows.Ink.AnalysisCore.ContextNodeDeletingBaseEventArgs)

    ' Do not remove unclassified ink nodes from the document model.
    If System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.UnclassifiedInk <> e.NodeToBeDeleted.Type Then
        Me.baseDocumentModel.RemoveNode(e.NodeToBeDeleted)
    End If

End Sub 'RemoveContextNodeBase

        /// <summary>
        /// Handles the InkAnalyzerBase.ContextNodeDeletingBase event.
        /// </summary>
        /// <param name="sender">The source of the event.</param>
        /// <param name="e">The event data.</param>
        private void RemoveContextNodeBase(
            object sender, System.Windows.Ink.AnalysisCore.ContextNodeDeletingBaseEventArgs e)
        {
            // Do not remove unclassified ink nodes from the document model.
            if (System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.UnclassifiedInk
                != e.NodeToBeDeleted.Type)
            {
                this.baseDocumentModel.RemoveNode(e.NodeToBeDeleted);
            }
        }