Procédure d'ajout d'un gestionnaire d'événements
Cette rubrique décrit les procédures permettant d'ajouter des gestionnaires d'événements à un modèle de formulaire Microsoft InfoPath 2010 avec code managé avec Microsoft Visual Studio Tools for Applications. Pour ajouter un gestionnaire d'événements à un modèle de formulaire, vous ouvrez le modèle de formulaire dans le Concepteur InfoPath, puis vous sélectionnez la commande de l'interface utilisateur appropriée pour l'événement pour lequel vous souhaitez écrire du code. Une fois que vous avez sélectionné la commande pour un événement dans le Concepteur InfoPath, le squelette de gestionnaire d'événements de cet événement est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Important
L'ajout d'un gestionnaire d'événements avec l'interface utilisateur génère du code de liaison d'événement dans la méthode InternalStartup du fichier FormCode.cs ou FormCode.vb de votre projet de modèle de formulaire. Ne créez pas la méthode InternalStartup et n'y rajoutez aucun code supplémentaire par vous-même.
Ajout d'un gestionnaire d'événement pour l'événement Click d'un contrôle Bouton
Ouvrez le modèle de formulaire dans le Concepteur InfoPath, puis ajoutez un contrôle Bouton dans le formulaire.
Cliquez sur le bouton, puis sous l'onglet Propriétés du ruban, cliquez sur Code personnalisé.
Le squelette de gestionnaire d'événements de l'événement Clicked est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Ajout d'un gestionnaire d'événements pour l'événement Changing, Validating ou Changed d'un champ ou d'un groupe
Ouvrez le modèle de formulaire dans le Concepteur InfoPath.
Cliquez avec le bouton droit de la souris sur un contrôle d'entrée de données lié au champ ou au groupe, par exemple un contrôle Zone de texte.
Pointez vers Programmation, puis cliquez sur l'événement pour lequel vous souhaitez créer un gestionnaire d'événements. Le squelette de gestionnaire d'événements de l'événement Changing, Validating ou Changed dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Notes
La commande servant à créer un gestionnaire d'événements pour l'événement Changing n'est pas disponible si le paramètre de compatibilité pour le modèle de formulaire st défini sur Formulaire de navigateur Web. L'événement Changing n'est pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents dans Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d'événements pour l'événement Changing, vous devez modifier le paramètre de compatibilité sur Éditeur InfoPath du Concepteur InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.
Ajout d'un gestionnaire d'événements pour les événements Loading, ViewSwitched, ContextChanged et Sign d'un formulaire
Ouvrez le modèle de formulaire dans le Concepteur InfoPath.
Sous l'onglet Développeur du ruban, cliquez sur l'événement de formulaire pour lequel vous souhaitez écrire un gestionnaire d'événements.
Le squelette du gestionnaire d'événements de l'événement Loading, ViewSwitched, ContextChanged ou Sign est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Notes
Les commandes servant à créer un gestionnaire d'événements pour l'événement ContextChanged ou Sign ne sont pas disponibles pour le paramètre de compatibilité du modèle de formulaire est défini sur Formulaire de navigateur Web. Ces événements ne sont pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d'événements pour l'événement ContextChanged ou Sign, vous devez modifier le paramètre de compatibilité sur Formulaire de l'Éditeur InfoPath dans le Concepteur InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.
Ajout d'un gestionnaire d'événements pour l'événement Submit d'un formulaire
Ouvrez le modèle de formulaire dans le Concepteur InfoPath.
Cliquez sur l'onglet Fichier, cliquez sur Envoyer à sous l'onglet Infos, puis cliquez sur Options d'envoi.
Activez la case à cocher Autoriser les utilisateurs à envoyer ce formulaire, cliquez sur Effectuer une action personnalisée à l'aide du code, puis sur Modifier le code.
Le squelette de gestionnaire d'événements de l'événement Submit est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Ajout d'un gestionnaire d'événements pour l'événement Save d'un formulaire
Ouvrez le modèle de formulaire dans le Concepteur InfoPath.
Cliquez sur l'onglet Fichier, puis cliquez sur Options de formulaire sous l'onglet Infos.
Cliquez sur la catégorie Enregistrer, activez la case à cocher Enregistrer au moyen d'un code personnalisé, puis cliquez sur Modifier.
Le squelette de gestionnaire d'événements de l'événement Save est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Notes
La case à cocher Enregistrer au moyen d'un code personnalisé n'est pas disponible si le paramètre de compatibilité du modèle de formulaire est défini sur InfoPath Forms Services. L'événement Save n'est pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents dans Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d'événements pour l'événement Save, vous devez modifier le paramètre de compatibilité sur Formulaire de l'Éditeur InfoPath dans le Concepteur InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, cliquez sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.
Ajout d'un gestionnaire d'événements pour l'événement VersionUpgrade d'un formulaire
Ouvrez le modèle de formulaire dans le Concepteur InfoPath.
Cliquez sur l'onglet Fichier, puis cliquez sur Options de formulaire sous l'onglet Infos.
Cliquez sur la catégorie Contrôle de version, sélectionnez Utiliser un événement personnalisé dans la liste déroulante Mettre à jour les formulaires existants, puis cliquez sur Modifier.
Le squelette de gestionnaire d'événements de l'événement Save est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Ajout d'un gestionnaire d'événements pour l'événement Merge d'un formulaire
Ouvrez le modèle de formulaire dans le Concepteur InfoPath.
Cliquez sur l'onglet Fichier, puis cliquez sur Options de formulaire sous l'onglet Infos.
Cliquez sur la catégorie Avancé, activez la case à cocher Activer la fusion de formulaires, activez la case à cocher Fusionner à l'aide d'un code personnalisé cliquez sur Modifier.
Le squelette de gestionnaire d'événements de l'événement Merge est activé dans l'éditeur de code Microsoft Visual Studio Tools for Applications.
Notes
La case à cocher Fusionner à l'aide d'un code personnalisé n'est pas disponible si le paramètre de compatibilité du modèle de formulaire est défini sur InfoPath Forms Services. L'événement Merge n'est pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents dans Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d'événements pour l'événement Merge, vous devez modifier le paramètre de compatibilité sur Formulaire de l'Éditeur InfoPath dans le Concepteur InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, cliquez sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.
Voir aussi
Tâches
Procédure pas à pas : Création d'un modèle de formulaire simple avec code managé