FormEvents.ViewSwitched Event

Reference

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Occurs after a view of a form has been successfully switched.

public:
 abstract event Microsoft::Office::InfoPath::ViewSwitchedEventHandler ^ ViewSwitched;

public abstract event Microsoft.Office.InfoPath.ViewSwitchedEventHandler ViewSwitched;

member this.ViewSwitched : Microsoft.Office.InfoPath.ViewSwitchedEventHandler

Public MustOverride Custom Event ViewSwitched As ViewSwitchedEventHandler

Event Type

ViewSwitchedEventHandler

Exceptions

InvalidOperationException

The developer attempted to bind the event in some location other than the InternalStartup method.

Examples

In the following example, the event handler for the ViewSwitched event is used to show the name of the view displayed when the view change occurs.

public void FormEvents_ViewSwitched(object sender, ViewSwitchedEventArgs e)
{
   MessageBox.Show("Loading the view: " + 
      this.CurrentView.ViewInfo.Name);
}

Public Sub FormEvents_ViewSwitched(sender As Object, _
   e As ViewSwitchedEventArgs)
   MessageBox.Show("Loading the view: " &amp; _
      Me.CurrentView.ViewInfo.Name)
End Sub

Remarks

Important: The ViewSwitched event is not meant to be instantiated by the developer in form code. You should only add event handlers for form-level events from the Microsoft InfoPath design mode user interface. When you add an event handler to your form template from the design mode user interface, InfoPath generates code in the InternalStartup method of your form code file using the EventManager class and the member of the FormEvents class to bind the event to its event handler. For information on how to add event handlers in InfoPath design mode, see How to: Add an Event Handler.

The ViewSwitched event is bound using the ViewSwitchedEventHandler delegate.

The ViewSwitched event cannot be cancelled.

Note: The ViewSwitched event also occurs when a form is first opened.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Applies to

Share via