DocContextChangeEventObject Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Implementaciones
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" && !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) |
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de