Cette section suppose que vous possédez au moins une maîtrise de base du langage de programmation Visual Basic. Si vous devez l'apprendre, consultez un ouvrage ou toute autre ressource externe à ce sujet.
La section Événements de la boîte de dialogue Propriétés présente la liste des fonctions du gestionnaire d'événements prises en charge par votre modèle ou forme. Une fonction est appelée chaque fois que l'événement désigné par le nom de la fonction se produit pour l'objet donné. Lorsque cette fonction est appelée, tout code Visual Basic qu'elle renferme est exécuté.
Fonctions disponibles pour le gestionnaire d'événements
EventClick
Code exécuté quand l'utilisateur clique sur l'objet avec la souris.
EventDblClick
Code exécuté quand l'utilisateur double-clique sur l'objet avec la souris.
EventDragDrop
Code exécuté quand un autre élément à « glisser-déplacer » est déposé sur l'objet.
EventDragEnter
Code exécuté quand un élément à « glisser-déplacer » est déplacé vers l'objet.
EventDragOver
Code exécuté quand un élément à « glisser-déplacer » est déplacé sur l'objet.
EventInitialize
Code exécuté quand la forme passe en mode exécution avant l'appel d'autres gestionnaires sur l'objet.
EventMouseDown
Code exécuté quand l'utilisateur appuie sur un bouton de la souris alors que le curseur se trouve sur l'objet. Si vous appuyez sur la touche Maj, les paramètres transmis à la fonction indiquent le bouton sur lequel vous appuyez, ainsi que les coordonnées du pointeur au moment où vous avez cliqué.
EventMouseMove
Code exécuté quand le curseur de la souris passe sur l'objet. Si vous appuyez sur la touche Maj, les paramètres transmis à la fonction indiquent le bouton sur lequel vous appuyez, ainsi que les coordonnées du pointeur quand vous déplacez le pointeur sur l'objet.
EventMouseUp
Code exécuté quand le bouton de la souris est relâché sur l'objet. Si vous appuyez sur la touche Maj, les paramètres transmis à la fonction indiquent le bouton sur lequel vous appuyez, ainsi que les coordonnées du pointeur au moment où vous relâchez le bouton.
EventPumpData
Il s'agit d'une fonction très utilisée dans l'éditeur de formes. EventPumpData est appelée chaque fois que des variables BASIC pouvant affecter l'objet changent de valeur. Votre code peut aussi forcer EventPumpData à s'exécuter pour des objets individuels (ou pour tous les objets d'un rapport) quand vous voulez qu'un objet se mette à jour automatiquement. En règle générale, tout code dont un objet a besoin pour se réinitialiser à partir de la valeur d'une variable ou de l'état d'autres objets doit se trouver dans EventPumpData.
EventTerminate
Code exécuté quand le rapport est fermé ou quand vous basculez du mode exécution au mode édition dans l'éditeur de formes.
Cette fonction du gestionnaire est uniquement disponible pour les environnements d'édition de la section.
EventReportData
Il s'agit d'une autre fonction très utilisée dans les éditeurs de modèles de rapports et d'étiquettes. Elle est appelée chaque fois que les données d'un rapport sont insérées dans le modèle en cours.
Sa mission première consiste à vous permettre de créer vos propres contrôles ActiveX placés dans une étiquette. Par exemple, les contrôles d'analyse de fonctions et best fit de PC-DMIS emploient cet événement pour envoyer des données au contrôle ActiveX depuis la commande. Pour le constater, ouvrez l'étiquette best_fit_analysis.lbl, cliquez sur le contrôle ActiveX dans cette étiquette et observez le code BASIC à l'intérieur du gestionnaire d'événements. Une ligne transmet des données de la commande au contrôle.
Une fois les données transmises à votre contrôle ActiveX, vous pouvez utiliser des commandes d'automatisation pour les extraire et les manipuler.
Pour des détails sur PC-DMIS Basic, voir la rubrique « PC-DMIS Basic » dans la documentation PC-DMIS Basic.
Pour des détails sur la bibliothèque d'objets d'automatisation PC-DMIS, voir la rubrique « Bibliothèque d'objets d'automatisation PC-DMIS » dans la documentation sur les objets d'automatisation PC-DMIS.
Cet événement est appelé une fois pour chaque commande lorsque vous appliquez le modèle de rapport ou pendant l'exécution de la routine de mesure.
Ajout de code à des gestionnaires d'événements
Pour ajouter du code BASIC à un gestionnaire d'événements :
Cliquez sur l'entrée de la fonction dans la liste de gestionnaires d'événements. Un mini-éditeur de langage Visual BASIC s'ouvre, et les instructions d'ouverture et de fermeture des sous-programmes sont déjà renseignées.
Entrez d'autres instructions en langage BASIC dans l'éditeur.
Cliquez sur OK.
Testez votre code.
Si vous utilisez l'éditeur de formes, appuyez sur Ctrl + E pour passer en mode exécution et tester votre forme.
Si vous utilisez l'un des éditeurs de modèles, appliquez le modèle à un rapport et concevez à nouveau ce dernier pour tester votre code. Pour ce faire, utilisez l'icône Retracer le rapport
dans la barre d'outils Génération de rapports.
Comme vous n'intervenez pas en cliquant sur des boutons, des listes, des zones ou d'autres éléments interactifs lorsque vous utilisez un rapport, la seule fonction du gestionnaire d'événements disponible est EventReportData.
Rubriques associées :
Exemple d'événement 1 : Appel de code sur un evénement EventClick
Exemple d'événement 2 : Modification des propriétés d'un objet au déclenchement d'un événement