DocContextChangeEventObject インターフェイス

定義

名前空間:

Microsoft.Office.Interop.InfoPath.SemiTrust

アセンブリ:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Microsoft InfoPath コンテキスト変更イベント中に使用されるイベント オブジェクト。

public interface class DocContextChangeEventObject : Microsoft::Office::Interop::InfoPath::SemiTrust::DocContextChangeEvent

[System.Runtime.InteropServices.Guid("096cd6d2-0786-11d1-95fa-0080c78ee3bb")]
public interface DocContextChangeEventObject : Microsoft.Office.Interop.InfoPath.SemiTrust.DocContextChangeEvent

type DocContextChangeEventObject = interface
    interface DocContextChangeEvent
    interface DocEvent

Public Interface DocContextChangeEventObject
Implements DocContextChangeEvent

属性

GuidAttribute

実装

DocContextChangeEvent

例

次の例では、コンテキストの変更に応じて という名前 lastChanged のノードが更新されます。

[InfoPathEventHandler(EventType=InfoPathEventType.OnContextChange)]
public void OnContextChange(<span class="label">DocContextChangeEvent</span> e)
{
 if ( e.Type == "ContextNode" &amp;&amp; !e.IsUndoRedo )
 {
  IXMLDOMNode contextNode = e.Context;
  IXMLDOMNode lastChangedNode = thisXDocument.DOM.selectSingleNode("/my:myRoot/my:lastChanged");
  lastChangedNode.text = contextNode.nodeName;
 }
}

注釈

この型は、COM の相互運用性を得るためにマネージ コードが必要とするコクラスのラッパーです。 この型を使用して、このコクラスによって実装される COM インターフェイスにアクセスします。 COM インターフェイスの詳細については、そのメンバーの説明へのリンクを参照してくださいDocContextChangeEvent。

DocContextChangeEvent オブジェクトにはコンテキスト変更で使用可能なプロパティが多数あり、フォームの基になる XML ドキュメント内のデータの操作、コンテキストに応じたフィードバックの提供、およびユーザー向けのさまざまな操作をプログラムで行うことができます。

DocContextChangeEvent オブジェクトは、イベントにOnContextChangeパラメーターとして渡されます。

DocContextChangeEvent オブジェクトは、フォームの基になる XML ドキュメントの現在のコンテキストである XML ドキュメント オブジェクト モデル (DOM) ノードに関する情報を取得するために使用します。 また、コンテキスト変更の種類に関する情報、およびコンテキスト変更がユーザーによる元に戻す操作またはやり直し操作に応える形で発生したのかどうかに関する情報も取得できます。

プロパティは Type 、Microsoft InfoPath のコンテキスト変更の値 "ContextNode" のみを返します。 ただし、イベント ハンドラーで現在の機能に依存する操作を実行する場合は、InfoPath の今後のバージョンでコンテキスト変更に使用される値が変更されることも考えられるため、Type プロパティの値を確認するようにコードを設計する必要があります。

プロパティが IsUndoRedotrue の場合、コンテキストの変更は、明示的なユーザー コンテキストの変更ではなく、元に戻す操作またはやり直し操作によって発生しました。 ユーザーの意向とは無関係にデータを以前の状態に戻してしまうことがあるため、OnContextChange イベント内では元に戻す操作またはやり直し操作に応える形で XML DOM を変更する操作を実行しないでください。

プロパティ

Context	オブジェクトによって提供される新しいコンテキスト ノードである XML ドキュメント オブジェクト モデル (DOM) ノードへの参照を DocContextChangeEventObject 取得します。 (継承元 DocContextChangeEvent)
IsUndoRedo	操作の取り消しまたはやり直しに対応してコンテキスト変更イベントが発生したかどうかを示す値を取得します。 (継承元 DocContextChangeEvent)
Type	イベントがトリガーされたときに発生したコンテキスト変更イベントの種類を OnContextChange 取得します。 (継承元 DocContextChangeEvent)
XDocument	イベント内の オブジェクトに XDocument 関連付 DocContextChangeEventObject けられているオブジェクトへの参照を OnContextChange 取得します。 (継承元 DocContextChangeEvent)