L'Assistant "Module"

L'assistant Module remplit 2 fonctions pratiques si vous programmez en Visual Basic dans Access :

• Faciliter la gestion des commentaires dans votre code source
• Automatiser la saisie de code répétitif grâce au principe des "Insertions automatiques" inspiré de Word.
  

Installer et démarrer l'Assistant

Pour installer l'Assistant :

1. Téléchargez le fichier wzModWiz.zip (35 K environ)
2. Décompactez-le sur votre disque dur.
3. Installez l'Assistant "Module Wizard" dans Access (voir la fiche Installation d'un Assistant pour plus de détails).

Pour utiliser l'Assistant :

1. Ouvrez votre base de données.
2. Ouvrez un module quelconque.
3. Faites apparaître la barre d'outils "Création de macros" via le menu Affichage / Barres d'outils / Personnaliser. L'icône "Générer" donne accès à toutes les fonctionnalités de l'Assistant (voir plus bas).

Conseil

Si vous utilisez souvent l'Assistant Module, il vaut mieux placer l'icône "Générer" sur la barre d'outils Visual Basic, ce qui vous permet de masquer la barre d'outils "Création de macros".

Commenter un bloc

Si vous programmez en Visual Basic, vous savez qu'une ligne de commentaires commence par une apostrophe. Le problème est qu'il n'existe pas d'icône permettant de commenter tout un bloc, contrairement à Excel. Voilà qui est réparé :o)

Pour "commenter" un bloc :

• Sélectionnez le bloc de code à transformer en commentaires.
• Cliquez sur l'icône
• Sélectionnez ensuite l'option Commentaires - Appliquer

Pour ôter les commentaires :

• Sélectionnez le bloc de code.
• Cliquez sur l'icône
• Sélectionnez ensuite l'option Commentaires - Supprimer.

Commenter une procédure ou une fonction

Il est toujours pratique de commenter une procédure ou une fonction (que fait la fonction, quels paramètres doivent être fournis, quelle valeur est renvoyée).

Voici comment faire pour automatiser tout ça !

• Sélectionnez la ligne de déclaration de la procédure ou de la fonction, par exemple :

Public Function Initiale(ByVal strMot As String) As String

• Cliquez sur l'icône
• Sélectionnez ensuite l'option Commentaires - Procédure/Fonction

Vous obtenez :

' --------------------------------------------------
' INITIALE
' --------------------------------------------------
' Auteur : Hervé INISAN
' Date : 19/04/99 19:53:00
' Entrée :   strMot <-
' Sortie : Initiale ->
'
Public Function Initiale(ByVal strMot As String) As String
End Function

Il ne reste plus qu'à rajouter une description des paramètres d'entrée et de sortie de la fonction, de façon à obtenir par exemple :

' --------------------------------------------------
' INITIALE, Mise en majuscule de la 1ère lettre d'un mot
' --------------------------------------------------
' Auteur : Hervé INISAN
' Date : 19/04/99 19:53:00
' Entrée :   strMot <- Mot à traiter
' Sortie : Initiale -> Mot avec 1ère lettre en majuscule
'
Public Function Initiale(ByVal strMot As String) As String
End Function

Pour paramétrer le type de commentaires :

• Cliquez sur l'icône
• Cliquez sur l'option Commentaires - Options.

Sont modifiables : le caractère servant de titre, le nom de l'auteur, le fait que l'auteur, la date et le nom de la fonction apparaissent ou non dans les commentaires.

 

Insertions automatiques

Avez-vous remarqué que les mêmes morceaux de code source reviennent souvent, à quelques changements près ? Il est bien sûr possible de tout retaper à chaque fois, ou de faire du Copier/Coller depuis une procédure existante. Les insertions automatiques vont vous simplifier tout ça :

Pour utiliser une insertion automatique :

• Cliquez dans votre code source, à l'endroit voulu.
• Cliquez sur l'icône
• Cliquez sur l'option Insertions automatiques.

La boîte suivante apparaît :

• Dans la liste de gauche, sélectionnez une insertion automatique (le code source associé apparaît à droite).
• Cliquez enfin sur le bouton Insérer.

Plus rapidement :
vous pouvez également double-cliquer sur une insertion automatique.

Pour créer vos propres insertions automatiques :

• Dans le module, sélectionnez la portion de code à transformer en Insertion automatique.
• Cliquez sur l'icône Copier.
• Cliquez sur l'icône
• Cliquez sur l'option Insertions automatiques.
• Dans la boîte, cliquez sur le bouton + (une insertion nommée Sans titre est ajoutée).
• Dans la partie droite de l'écran :
  • Définissez le titre de votre insertion
  • Collez le code (bouton droit de la souris, puis Coller).

Pour supprimer une insertion automatique :

• Cliquez sur l'icône
• Cliquez sur l'option Insertions automatiques.
• Dans la liste de gauche, sélectionnez une insertion auto.
• Cliquez sur le bouton -

Notes

Vous pouvez aussi faire profiter les autres de vos insertions automatiques : il suffit de me transmettre votre fichier wzModWiz.mde (compacté par Winzip). Je les incorporerai dans les futures mises à jour de l'Assistant (avec vos coordonnées dans la zone Commentaires; à tout seigneur...)

Access 2000

L'assistant Module n'existe pas en version Access 2000, parce que celui-ci apporte des fonctionnalités équivalentes. "Microsoft m'a copier" :o) Voici comment obtenir les équivalents dans Ac2000 :

Commenter un bloc de code et enlever les commentaires :

1. Ouvrez un module quelconque.
2. Faites apparaître la barre d'outils Edition (Affichage / Barres d'outils / Edition).
3. Sur cette barre d'outils figurent 2 icônes "Commenter bloc" et "Ne pas commenter bloc".

Commenter une procédure ou une fonction :

1. Ouvrez un module quelconque.
2. Cliquez sur le menu Compléments, puis sur l'option Gestionnaire de compléments.
3. Dans la liste des compléments, double-cliquez sur "Commentaire de code VBA".

Une fois le complément installé, il suffit d'utiliser le menu Compléments / Commentaire de code VBA.

Utiliser des insertions automatiques :

1. Ouvrez un module quelconque.
2. Cliquez sur le menu Compléments, puis sur l'option Gestionnaire de compléments.
3. Dans la liste des compléments, double-cliquez sur "Bibliothèque de code".

Une fois le complément installé, il suffit d'utiliser le menu Compléments / Bibliothèque de code.