FormEvents.ViewSwitched, événement

Article
04/27/2010

Se produit lors d'un changement de vue réussi d'un formulaire.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

Public Event ViewSwitched As ViewSwitchedEventHandler

Dim instance As FormEvents
Dim handler As ViewSwitchedEventHandler

AddHandler instance.ViewSwitched, handler

public abstract event ViewSwitchedEventHandler ViewSwitched

Exceptions

Type d'exception	Condition
InvalidOperationException	Le développeur a tenté de lier l'événement dans un emplacement autre que la méthode InternalStartup.

Remarques

Important :
L'événement ViewSwitched n'est pas destiné à être instancié par le développeur dans le code de formulaire. Vous ne devez ajouter des gestionnaires d'événements pour les événements au niveau du formulaire qu'à partir de l'interface utilisateur Microsoft Office InfoPath 2007 en mode Création. Lorsque vous ajoutez un gestionnaire d'événements à votre modèle de formulaire à partir de l'interface utilisateur en mode Création, InfoPath génère du code dans la méthode InternalStartup du fichier de code de votre formulaire à l'aide de la classe EventManager et du membre de la classe FormEvents pour lier l'événement à son gestionnaire d'événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure d'ajout d'un gestionnaire d'événements.

L'événement ViewSwitched n'est pas destiné à être instancié par le développeur dans le code de formulaire. Vous ne devez ajouter des gestionnaires d'événements pour les événements au niveau du formulaire qu'à partir de l'interface utilisateur Microsoft Office InfoPath 2007 en mode Création. Lorsque vous ajoutez un gestionnaire d'événements à votre modèle de formulaire à partir de l'interface utilisateur en mode Création, InfoPath génère du code dans la méthode InternalStartup du fichier de code de votre formulaire à l'aide de la classe EventManager et du membre de la classe FormEvents pour lier l'événement à son gestionnaire d'événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure d'ajout d'un gestionnaire d'événements.

L'événement ViewSwitched est lié à l'aide du délégué ViewSwitchedEventHandler.

L'événement ViewSwitched ne peut pas être annulé.

Remarque
L'événement ViewSwitched se produit également à l'ouverture initiale d'un formulaire.

Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007 ou un navigateur Web.

Exemple

Dans l'exemple suivant, le gestionnaire de l'événement ViewSwitched est utilisé pour afficher le nom de la vue lorsque celle-ci change :

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

Voir aussi

Référence

FormEvents, classe
Membres FormEvents
Microsoft.Office.InfoPath, espace de noms

Partager via