Interfaz DocContextChangeEventObject

Objeto de evento que se utiliza durante un evento de cambio de contexto de Microsoft InfoPath.

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
<GuidAttribute("096cd6d2-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DocContextChangeEventObject _
    Inherits DocContextChangeEvent, DocEvent
'Uso
Dim instance As DocContextChangeEventObject

[GuidAttribute("096cd6d2-0786-11d1-95fa-0080c78ee3bb")]
public interface DocContextChangeEventObject : DocContextChangeEvent, 
    DocEvent

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. Encontrará información sobre la interfaz COM, así como vínculos a las descripciones de sus miembros, enDocContextChangeEvent.

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 evento OnContextChange.

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 propiedad Type devuelve sólo el valor "ContextNode" en los cambios de contexto producidos 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 propiedad IsUndoRedo es true, el cambio de contexto se produjo debido a una operación deshacer o rehacer, más que por un cambio de contexto explícito provocado por el usuario. 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.

Ejemplos

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

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

Vea también

Referencia

Miembros DocContextChangeEventObject

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust