FormEvents.ContextChanged (Evento)

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

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

Public Event ContextChanged As ContextChangedEventHandler

Dim instance As FormEvents
Dim handler As ContextChangedEventHandler

AddHandler instance.ContextChanged, handler

public abstract event ContextChangedEventHandler ContextChanged

Excepciones

Tipo de excepción	Condición
InvalidOperationException	El programador intentó enlazar el evento en una ubicación que no es el método InternalStartup.

Comentarios

Importante:

El programador no debe crear instancias del evento ContextChanged en el código de formulario. Sólo debe agregar controladores de eventos para eventos del documento desde la interfaz de usuario del modo de diseño de Microsoft Office InfoPath 2007. Al agregar un controlador de eventos a la plantilla de formulario desde la interfaz de usuario de modo de diseño, InfoPath genera código en el método InternalStartup del archivo de código de formulario mediante la clase EventManager y el miembro de la clase FormEvents para enlazar el evento a su controlador de eventos. Para obtener información sobre cómo agregar controladores de eventos en el modo de diseño de InfoPath, vea Cómo agregar un controlador de eventos.

El evento ContextChanged se enlaza utilizando el delegado ContextChangedEventHandler.

El nodo de contexto es el nodo XML 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 extensible, el nodo de contexto será el nodo de ese elemento. Si se seleccionan dos secciones extensibles, el nodo de contexto será el nodo XML primario de ambos elementos asignado a esa vista.

El evento ContextChanged es asíncrono. 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 XML subyacente, o cuando se produce un cambio de vista, el evento ContextChanged se inicia una vez producidos los eventos Loading y ViewSwitched.

Cuando la propiedad UndoRedo del objeto ContextChangedEventArgs 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. Deberían evitarse las operaciones realizadas en el evento ContextChanged que modifica el documento XML subyacente 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 Cuadro de texto enriquecido, el evento ContextChanged no se inicia en los cambios de contexto dentro del contenido XHTML, es decir, en los cambios de selección del texto enriquecido del control. Para determinar la selección en los controles de Cuadro de texto enriquecido se puede usar el método GetContextNodes.

Se puede tener acceso a este tipo o miembro solamente desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007.

Ejemplo

En el siguiente ejemplo se supone que el formulario tiene un control de Cuadro de texto enlazado a un campo llamado DisplayContext, además de controles enlazados a otros campos y grupos del formulario. Si se mueve la selección a otros campos y grupos se muestra el nombre del campo o grupo en el control Cuadro de texto enlazado a DisplayContext.

public void FormEvents_ContextChanged(object sender, 
   ContextChangedEventArgs e)
{
   if (e.ChangeType == "ContextNode")
   {
      // Position a XPathNavigator on the DisplayContext field.
      XPathNavigator root, txtbox;
      root = this.MainDataSource.CreateNavigator();
      txtbox = root.SelectSingleNode("/my:myFields/my:DisplayContext", 
         this.NamespaceManager);

      // Set DisplayContext with the name of the current context.
      txtbox.SetValue(e.Context.Name);
      return;
   }
}

Public Sub FormEvents_ContextChanged(ByVal sender As Object, _
   ByVal e As ContextChangedEventArgs)
   If (e.ChangeType = "ContextNode") Then
      ' Position a XPathNavigator on the DisplayContext field.
      Dim root, txtbox As XPathNavigator
      root = Me.MainDataSource.CreateNavigator
      txtbox = root.SelectSingleNode("/my:myFields/my:DisplayContext", 
         Me.NamespaceManager)

      ' Set DisplayContext with the name of the current context.
      txtbox.SetValue(e.Context.Name)
      Return
   End If
End Sub

Vea también

Referencia

FormEvents (Clase)
FormEvents (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)