Créer un gestionnaire d'événements

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Lors de l’écriture de script pour un modèle de formulaire Microsoft Office InfoPath, vous en règle générale, écrivez du code dans un de l’écran gestionnaires d’événements validation des données ou de modèle. Un gestionnaire d’événements est le code de la fonction dans un modèle de formulaire InfoPath qui répond à une action utilisateur ou une modification de données XML dans un formulaire. Comment créer 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 les déclarations de gestionnaires d’événements dans le fichier de script automatiquement et crée des entrées dans le fichier de fichier de définition de formulaire qui permettent à un modèle de formulaire à 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 chacun des gestionnaires d’événements InfoPath et les étapes permettant de les créer. Lorsque vous créez un gestionnaire d’événements pour un modèle de formulaire, InfoPath démarre Microsoft Script Editor (MSE) et place le curseur dans le code de gestionnaire d’événements. Vous pouvez ensuite é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 informations de référence du développeur InfoPath, qui est disponible dans l’aide de MSE.

Event handler

Description

Steps for creating

OnAfterChange

Cet événement s’exécute lorsqu’un utilisateur modifie la valeur dans le contrôle lié à un champ. Par exemple, vous pouvez afficher un volet Office HTML personnalisé après qu’un utilisateur sélectionne un élément dans un contrôle de zone de liste. Cet événement s’exécute après l’événement OnValidate .

Avec le bouton droit à un contrôle sur le modèle de formulaire ou 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.

OnAfterImport

Cet événement s’exécute une fois que l’utilisateur fusionné plusieurs formes dans un formulaire.

Ajouter manuellement la déclaration de gestionnaire d’événements OnAfterImport directement au fichier de script à l’aide de MSE. Ce gestionnaire d’événements ne peut pas être créé en mode Création.

OnBeforeChange

Cet événement s’exécute lorsqu’un utilisateur modifie la valeur d’un contrôle et avant que la valeur est ajoutée au champ spécifié lié à ce contrôle. Par exemple, vous pouvez empêcher un utilisateur d’ajouter une ligne supplémentaire avant de remplir la dernière ligne dans un tableau extensible.

Avec le bouton droit à un contrôle sur le modèle de formulaire ou 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.

OnClick

Cet événement s’exécute lorsqu’un utilisateur clique sur un bouton associé à cet événement. Cet événement est disponible une fois que vous ajoutez un bouton au modèle de formulaire. Par exemple, vous pouvez effectuer des calculs complexes en utilisant les valeurs dans les champs de la source de données principale lorsqu’un utilisateur clique sur le bouton.

Double-cliquez sur le bouton de contrôle et 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 est modifié dans le formulaire. Par exemple, cet événement s’exécute lorsqu’un utilisateur accède à partir d’une zone de texte par un sélecteur de dates, ou lorsqu’un utilisateur bascule entre les vues. Cet événement se produit après que tous les autres événements se sont produites.

Dans le menu Outils, pointez sur programmation, puis cliquez sur Événement sur Modification du contexte.

OnLoad

Cet événement s’exécute chaque fois qu’un utilisateur crée un nouveau formulaire ou ouvre un formulaire existant basé sur votre modèle de formulaire. Par exemple, vous pouvez copier une liste d’éléments à partir d’une source de données secondaire à 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.

OnMergeRequest

Cet événement s’exécute lors de la fusionnent de formulaires basés sur votre modèle de formulaire. Par exemple, vous pouvez afficher le nombre de formulaires qui ont été fusionnées pour donner à un utilisateur un statut pendant 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 de 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 à plusieurs endroits 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 ligne qui vous indique si InfoPath enregistré correctement le formulaire.

Dans le menu Outils, cliquez sur Options de formulaire. Dans la liste catégorie, cliquez sur Ouvrir et enregistrer. Sous comportement à l’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 s’applique une signature numérique à un formulaire. Par exemple, vous pouvez ajouter des données supplémentaires pour la signature numérique d’un formulaire de note de frais lorsqu’un utilisateur s’il.

Dans le menu Outils, pointez sur programmation, puis cliquez sur Événement signé.

OnSubmitRequest

Cet événement s’exécute lorsqu’un utilisateur soumet ses données de formulaire. Par exemple, vous pouvez envoyer les données de 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 à 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 de 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 vers un autre affichage dans le formulaire. Par exemple, lorsqu’un utilisateur bascule vers une vue spécifique, vous pouvez créer un message électronique qui contienne des données à partir des champs dans la source de données principale du formulaire.

Dans le menu Outils, cliquez sur programmation, puis cliquez sur Commutateur afficher l’événement.

OnValidate

Cet événement s’exécute lorsqu’un utilisateur modifie la valeur d’un contrôle lié à un champ. Par exemple, lorsque l’utilisateur modifie la valeur d’un contrôle spécifique, vous pouvez calculer une nouvelle valeur pour un autre contrôle en utilisant le numéro entrées par l’utilisateur et un numéro qui se trouve dans le script. Cet événement se produit après l’exécution du Gestionnaire d’événements OnBeforeChange .

Avec le bouton droit à un contrôle sur le modèle de formulaire ou 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 valider.

OnVersionUpgrade

Cet événement s’exécute lorsqu’un utilisateur s’ouvre un formulaire existant et le numéro de version du modèle de formulaire utilisé par le formulaire existant est plus anciens que le numéro de version du modèle de formulaire dans l’emplacement de publication. Lorsqu’un utilisateur ouvre un formulaire existant, InfoPath vérifie le numéro de version du 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, supposons que vous pouvez ajouter un nouveau champ à un modèle de formulaire existant et republier, et vous souhaitez que le nouveau champ à ajouter à 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 de formulaire. Dans la liste catégorie, cliquez sur le contrôle de version. Dans la liste sur une version mise à niveau, cliquez sur utiliser un événement personnalisé, puis cliquez sur Modifier.

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×