DocContextChangeEventObject Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Objeto de evento que se usa durante un evento de cambio de contexto de 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

Atributos

GuidAttribute

Implementaciones

DocContextChangeEvent

Ejemplos

En el ejemplo siguiente, se actualiza un nodo denominado lastChanged en respuesta a los cambios de contexto:

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

Comentarios

Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Para obtener información sobre la interfaz COM, incluido un vínculo a las descripciones de sus miembros, consulteDocContextChangeEvent .

El objeto DocContextChangeEvent proporciona varias propiedades que se pueden usar en un cambio de contexto para interactuar mediante programación con los datos del documento XML subyacente de un formulario a fin de proporcionar respuesta contextual al usuario o para realizar acciones por él.

El objeto DocContextChangeEvent se pasa como parámetro al OnContextChange evento.

El objeto DocContextChangeEvent se usa para obtener información sobre el nodo del Modelo de objetos de documentos (DOM) XML que es el contexto actual del documento XML subyacente del formulario. Además, proporciona información sobre el tipo de cambio de contexto y sobre si dicho cambio sucedió en respuesta a una operación deshacer o rehacer emprendida por el usuario.

La Type propiedad devuelve solo el valor "ContextNode" para los cambios de contexto en Microsoft InfoPath. No obstante, si el código de un controlador de eventos realiza acciones que dependen de la funcionalidad actual, éste se deberá diseñar para que se compruebe el valor de la propiedad Type, ya que es posible que las futuras versiones de InfoPath utilicen valores distintos para cambios de contexto diferentes.

Cuando la IsUndoRedo propiedad es true, el cambio de contexto se produjo por una operación de deshacer o rehacer en lugar de un cambio de contexto de usuario explícito. Deberían evitarse las operaciones en un evento OnContextChange que modifiquen el XML DOM en respuesta a acciones deshacer o rehacer, ya que pueden interferir con la intención del usuario de revertir datos a un estado anterior.

Propiedades

Context	Obtiene una referencia al nodo Modelo de objetos de documento (DOM) XML que es el nuevo nodo de contexto proporcionado por DocContextChangeEventObject el objeto . (Heredado de DocContextChangeEvent)
IsUndoRedo	Obtiene un valor que indica si el evento de cambio de contexto se produjo en respuesta a una operación de deshacer o rehacer. (Heredado de DocContextChangeEvent)
Type	Obtiene el tipo de evento de cambio de contexto que se produjo cuando se desencadenó el OnContextChange evento. (Heredado de DocContextChangeEvent)
XDocument	Obtiene una referencia al XDocument objeto asociado al DocContextChangeEventObject objeto en un OnContextChange evento. (Heredado de DocContextChangeEvent)