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

注解

此类型是用于 Coclass（托管代码需要此 Coclass 来实现 COM 互操作性）的包装。 使用此类型来访问由此 Coclass 实现的 COM 接口。 有关 COM 接口的信息（包括指向其成员说明的链接），请参阅DocContextChangeEvent。

DocContextChangeEvent 对象提供了许多属性，使用这些属性，可以在上下文更改中以编程方式与表单的基础 XML 文档中数据进行交互、向用户提供上下文反馈或者执行用户的操作。

DocContextChangeEvent 对象作为参数传递给事件OnContextChange。

DocContextChangeEvent 对象可以用来获取有关 XML 文档对象模型 (DOM) 节点（即表单的基础 XML 文档当前的上下文）的信息。 此外，它还提供关于上下文更改类型以及更改是否因为响应用户执行的撤消或恢复操作而发生的信息。

属性 Type 仅返回 Microsoft InfoPath 中上下文更改的值“ContextNode”。 但是，如果事件处理程序中的代码执行的操作依赖于当前功能，那么，仍应当将该代码设计为检查 Type 属性的值，因为 InfoPath 后续版本可能对不同的上下文更改使用不同的值。

IsUndoRedo当 属性为 true 时，上下文更改是由撤消或重做操作而不是显式用户上下文更改引起的。 作为对撤消或恢复操作的响应，应该避免在 OnContextChange 事件中修改 XML DOM，因为执行这些操作可能会影响用户将数据恢复到以前的状态。

属性

Context	获取对 XML 文档对象模型的引用 (DOM) 节点，该节点是由 对象提供 DocContextChangeEventObject 的新上下文节点。 (继承自 DocContextChangeEvent)
IsUndoRedo	获取一个值，指示是否发生上下文更改事件以响应撤消操作或恢复操作。 (继承自 DocContextChangeEvent)
Type	获取触发事件时 OnContextChange 发生的上下文更改事件的类型。 (继承自 DocContextChangeEvent)
XDocument	获取对XDocument与事件中的 OnContextChange 对象关联的 DocContextChangeEventObject 对象的引用。 (继承自 DocContextChangeEvent)