FormEvents.ViewSwitched-Ereignis
Tritt ein, nachdem eine Ansicht eines Formulars erfolgreich gewechselt wurde.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Event ViewSwitched As ViewSwitchedEventHandler
'Usage
Dim instance As FormEvents
Dim handler As ViewSwitchedEventHandler
AddHandler instance.ViewSwitched, handler
public abstract event ViewSwitchedEventHandler ViewSwitched
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Es wurde versucht, das Ereignis an einen anderen Speicherort als die InternalStartup-Methode zu binden. |
Hinweise
Wichtig
Das ViewSwitched-Ereignis sollte nicht vom Entwickler im Formularcode instanziiert werden. Ereignishandler für Ereignisse auf Formularebene sollten nur über die Microsoft InfoPath 2010-Entwurfsmodus-Benutzeroberfläche hinzugefügt werden. Wenn Sie der Formularvorlage über die Entwurfsmodus-Benutzeroberfläche einen Ereignishandler hinzufügen, wird in InfoPath mithilfe der EventManager-Klasse und des Members der FormEvents-Klasse in der InternalStartup-Methode der Formularcodedatei Code generiert, um das Ereignis an den zugehörigen Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.
Die Bindung des ViewSwitched-Ereignisses erfolgt mithilfe des ViewSwitchedEventHandler-Delegaten.
Das ViewSwitched-Ereignis kann nicht abgebrochen werden.
Hinweis
Das ViewSwitched-Ereignis tritt auch ein, wenn ein Formular zum ersten Mal geöffnet wird.
Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel wird der Ereignishandler für das ViewSwitched-Ereignis verwendet, um beim Wechsel der Ansicht den Ansichtsnamen anzuzeigen:
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: " & _
Me.CurrentView.ViewInfo.Name)
End Sub