Evento _XDocumentEventSink2_Event.OnContextChange

Se produce después de que cambie el nodo de contexto.

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

Sintaxis

'Declaración
Event OnContextChange As _XDocumentEventSink2_OnContextChangeEventHandler
'Uso
Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnContextChangeEventHandler

AddHandler instance.OnContextChange, handler

event _XDocumentEventSink2_OnContextChangeEventHandler OnContextChange

Comentarios

El nodo de contexto es el nodo XML DOM asignado a la vista que corresponde al contenedor (o elemento) con la selección XML actual. Por ejemplo, si la selección actual en la vista se encuentra en un cuadro de texto, el nodo de contexto será el nodo al que esté enlazado el cuadro de texto. Si la selección actual es una sección de repetición, el nodo de contexto será el nodo de ese elemento. Si se seleccionan dos secciones de repetición, el nodo de contexto será el XML DOM primario de ambos elementos asignado a esa vista.

El evento OnContextChange es asincrónico. No se activa con cada cambio del nodo de contexto, sino que se inicia una vez que la aplicación ha terminado de procesar otros eventos.

Cuando se carga el documento, o cuando se produce un cambio de vista, el evento OnContextChange se inicia una vez producidos los eventos OnLoad y OnSwitchView.

Cuando la propiedad IsUndoRedo del objeto DocContextChangeEventObject es true, el cambio de contexto lo produce una operación deshacer o rehacer del usuario, no un cambio explícito de contexto realizado por éste. Se deberían evitar las operaciones realizadas en el evento OnContextChange que modifica el XML DOM en respuesta a operaciones deshacer o rehacer, ya que pueden interferir con las intenciones del usuario de revertir datos a su estado anterior.

En el caso de controles de cuadros de texto enriquecido, el evento OnContextChange no se inicia en los cambios de contexto dentro del contenido XHTML, es decir, en los cambios de selección en el texto enriquecido del control. Para determinar la selección en los controles de cuadro de texto enriquecido, se puede usar el método GetContextNodes.

Ejemplos

public void OnContextChange(DocContextChangeEvent e)
{
if (e.Type == "ContextNode")
{
IXMLNode expNode=XDocument.DOM.selectSingleNode("//my:field4");
// set field4 with the name of the current context.
expNode.text=e.Context.nodeName;
}
}

Vea también

Referencia

interfaz _XDocumentEventSink2_Event

Miembros _XDocumentEventSink2_Event

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