Créer un gestionnaire d'événements

Lors de l'écriture de scripts pour un modèle de formulaire Microsoft Office InfoPath, vous écrivez généralement du code dans l'un des modèles de formulaire ou des gestionnaires d'événements pour la validation de données. Un gestionnaire d'événements correspond au code de fonction dans un modèle de formulaire InfoPath qui répond à une action d'utilisateur ou à une modification apportée aux données XML dans un formulaire. Votre mode de création d'un gestionnaire d'événements dépend du type d'événement que vous souhaitez utiliser. Il est important de créer le gestionnaire d'événements en mode Création car InfoPath crée automatiquement les déclarations de gestionnaires d'événements dans le fichier de script et insère automatiquement des entrées dans le fichier de définition de formulaire (.xsf) (fichier de définition du formulaire : fichier XML qui porte l’extension .xsf et qui contient des informations sur tous les autres fichiers et composants utilisés dans un formulaire, notamment les personnalisations de l’interface utilisateur, les schémas XML, les vues, la logique d’application, les événements et les paramètres de déploiement.), permettant au modèle de formulaire d'utiliser ces gestionnaires d'événements.

 Remarque   Bien que vous puissiez créer manuellement des gestionnaires d'événements dans le fichier de script et les activer manuellement en ajoutant les éléments appropriés au fichier .xsf, nous vous le déconseillons. Si une modification incorrecte est apportée au fichier .xsf, le modèle de formulaire risque d'être inutilisable.

Le tableau suivant répertorie chaque gestionnaire d'événements InfoPath et ses étapes de création. Lorsque vous créez un gestionnaire d'événements pour un modèle de formulaire, InfoPath démarre Microsoft Script Editor (MSE) (Microsoft Script Editor : permet d’ajouter du texte, de modifier des balises HTML et changer le code Microsoft Visual Basic Scripting Edition (VBScript) dans une page d’accès aux données. Dans Script Editor, vous pouvez également obtenir un aperçu de votre page telle qu’elle s’affichera dans un navigateur Web.) et place le curseur dans le code du gestionnaire d'événements. Vous pouvez alors écrire le script pour le gestionnaire d'événements. Pour plus d'informations sur les événements InfoPath et les gestionnaires d'événements, voir le guide de référence du développeur InfoPath disponible dans l'aide de MSE.

Gestionnaire d'événements Description Étapes de création
OnAfterChange Cet événement s'exécute une fois qu'un utilisateur a modifié la valeur dans le contrôle spécifié lié à un champ. Par exemple, vous pouvez afficher un volet Office HTML personnalisé une fois qu'un utilisateur a sélectionné un élément dans un contrôle de zone de liste. Cet événement s'exécute après l'événement OnValidate. Cliquez avec le bouton droit sur un contrôle dans le modèle de formulaire ou sur un champ dans le volet Office Source de données, pointez sur Programmation dans le menu contextuel, puis cliquez sur Événement Sur après modification (OnAfterChange).
OnAfterImport Cet événement s'exécute une fois que l'utilisateur a fusionné plusieurs formulaires en un. Ajoutez manuellement la déclaration du gestionnaire d'événement OnAfterImport directement au fichier script à l'aide de MSE. Ce gestionnaire d'événement ne peut pas être créé en mode Création.
OnBeforeChange Cet événement s'exécute une fois que l'utilisateur a changé la valeur dans un contrôle et avant que cette valeur ne soit ajoutée au champ spécifié lié à ce contrôle. Par exemple, vous pouvez empêcher qu'un utilisateur ajoute une ligne supplémentaire avant qu'il n'ait rempli la dernière ligne d'un tableau extensible. Cliquez avec le bouton droit sur un contrôle dans le modèle de formulaire ou sur un champ dans le volet Office Source de données, pointez sur Programmation dans le menu contextuel, puis cliquez sur Événement Sur avant modification (OnBeforeChange).
OnClick Cet événement s'exécute lorsqu'un utilisateur clique sur un bouton associé à cet événement. Cet événement est disponible après avoir ajouté un bouton au modèle de formulaire. Par exemple, vous pouvez effectuer un calcul complexe en utilisant les valeurs des champs de la source de données principale lorsqu'un utilisateur clique sur le bouton. Double-cliquez sur le contrôle du bouton, puis sous l'onglet Général de la boîte de dialogue Propriétés du bouton, cliquez sur Modifier le code du formulaire.
OnContextChange Cet événement s'exécute lorsque le focus change dans le formulaire. Par exemple, cet événement s'exécute lorsqu'un utilisateur passe d'une zone de texte à un sélecteur de dates ou lorsqu'il bascule vers une autre vue. Cet événement se produit une fois que tous les autres événements se sont produits. Dans le menu Outils, pointez sur Programmation, puis cliquez sur Événement Sur modification du contexte (OnContextChangeEvent).
OnLoad Cet événement s'exécute lorsqu'un utilisateur crée un nouveau formulaire ou ouvre un formulaire existant basé sur un modèle de formulaire. Par exemple, vous pouvez copier une liste d'éléments d'une source de données secondaire dans la source de données principale, lorsqu'un utilisateur ouvre le formulaire. Dans le menu Outils, pointez sur Programmation, puis cliquez sur Événement Sur chargement (OnLoad).
OnMergeRequest Cet événement s'exécute lorsque des formulaires basés sur votre modèle de formulaire sont fusionnés. Par exemple, vous pouvez afficher le nombre de formulaires fusionnés afin de donner à l'utilisateur un état de l'opération de fusion. Dans le menu Outils, cliquez sur Options de formulaire. Dans la liste Catégorie, cliquez sur Avancé. Sous Fusionner les formulaires, activez la case à cocher Fusionner à l'aide d'un code personnalisé, puis cliquez sur Modifier.
OnSaveRequest Cet événement s'exécute lorsqu'un utilisateur enregistre un formulaire basé sur votre modèle de formulaire. Par exemple, vous pouvez enregistrer le formulaire basé sur ce modèle de formulaire sur plusieurs emplacements lorsqu'un utilisateur enregistre le formulaire. InfoPath ajoute deux lignes de code supplémentaires à cet événement : une ligne qui enregistre le formulaire et une autre qui vous indique si InfoPath a enregistré le formulaire avec succès. Dans le menu Outils, cliquez sur Options de formulaire. Dans la liste Catégorie, cliquez sur Ouvrir et enregistrer. Sous Comportement d'enregistrement, activez la case à cocher Enregistrer au moyen d'un code personnalisé, puis cliquez sur Modifier.
OnSign Cet événement s'exécute lorsqu'un utilisateur applique une signature numérique à un formulaire. Par exemple, vous pouvez ajouter des données supplémentaires à la signature numérique d'une note de frais lorsqu'un utilisateur la signe. Dans le menu Outils, pointez sur Programmation, puis cliquez sur Événement Sur signature (OnSignEvent).
OnSubmitRequest Cet événement s'exécute lorsqu'un utilisateur envoie les données du formulaire. Par exemple, vous pouvez envoyer les données du formulaire vers un service Web sécurisé lorsque l'utilisateur clique sur Envoyer dans le menu Fichier. Dans la mesure où InfoPath ne prend pas en charge une connexion de données vers un service Web sécurisé, vous devez ajouter une connexion de données personnalisée qui fonctionne avec votre service Web sécurisé. Dans le menu Outils, 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 cliquez sur Modifier le code.
OnSwitchView Cet événement s'exécute lorsqu'un utilisateur ouvre un formulaire basé sur votre modèle de formulaire ou bascule dans une autre vue du formulaire. Par exemple, lorsqu'un utilisateur bascule dans une vue spécifique, vous pouvez créer un message électronique qui contient des données des champs contenus dans la source de données principale du formulaire. Dans le menu Outils, cliquez sur Programmation, puis sur Événement Sur vue modifiée (OnSwitchView).
OnValidate Cet événement s'exécute lorsqu'un utilisateur change la valeur d'un contrôle lié à un champ. Par exemple, lorsqu'un utilisateur change la valeur d'un contrôle spécifique, vous pouvez calculer une nouvelle valeur pour un autre contrôle en utilisant le chiffre que l'utilisateur a entré et un chiffre qui se trouve dans le script. Cet événement se produit après l'exécution du gestionnaire d'événements OnBeforeChange. Cliquez avec le bouton droit sur un contrôle dans le modèle de formulaire ou sur un champ dans le volet Office Source de données, pointez sur Programmation dans le menu contextuel, puis cliquez sur Événement Sur après validation (OnAfterValidate).
OnVersionUpgrade Cet événement s'exécute lorsqu'un utilisateur ouvre un formulaire existant et que le numéro de version du modèle de formulaire utilisé par le formulaire existant est plus ancien que le numéro de version du modèle de formulaire à l'emplacement de publication. Lorsqu'un utilisateur ouvre un formulaire existant, InfoPath contrôle le numéro de version de ce modèle de formulaire associé au formulaire existant. Si le modèle de formulaire a un numéro de version plus récent, InfoPath exécute le gestionnaire d'événements OnVersion lorsque l'utilisateur ouvre le formulaire existant. Par exemple, vous ajoutez un nouveau champ à un modèle de formulaire existant, le publiez de nouveau et souhaitez ajouter le nouveau champ à la source de données principale si un utilisateur ouvre un formulaire existant. Cet événement ajoute le nouveau champ à la source de données principale lorsqu'un utilisateur ouvre un formulaire existant. Dans le menu Outils, cliquez sur Options du formulaire. Dans la liste Catégorie, cliquez sur Gestion des versions. Dans la liste Mise à niveau de la version, cliquez sur Utiliser un événement personnalisé, puis sur Modifier.
 
 
S'applique à :
InfoPath 2007