INTRODUCTION Langage de script Pour les premières versions des outils bureautique que sont le tableur, le traitement de texte et la base de données personnelle, l objectif des éditeurs était de remplacer des outils mécaniques (calculatrice, machine à écrire et fiches cartonnées) par des versions électroniques fournissant les mêmes services : calculs sur des données numériques, enregistrement et mise en forme de document, stockage d informations structurées avec accès par des index. Mais avec l évolution de la puissance des machines, ces logiciels se sont vus étoffer de multiples fonctionnalités. La plus intéressante consiste à adjoindre aux principes de base (formules de calcul, saisie de texte ou exploitation des données par le langage SQL) un langage de script qui permettra d automatiser des tâches complexes ou répétitives, et de les rendre accessibles à travers des interfaces graphiques plus élaborées. Dans le cadre de la suite Microsoft Office, l éditeur a repris son langage phare, Visual Basic, en l adaptant à la manipulation de cellules, menus ou base de données. La version utilisée est alors Visual Basic for Applications ou VBA. Environnement objet Le langage VBA lui même présente toutes les caractéristiques d un langage de programmation standard : Structures de données : entiers, réels,booléens et chaînes de caractères, tableaux, etc Structures de contrôle : IF THEN ELSE END IF, SELECT CASE END SELECT, Boucles (FOR, WHILE WEND, DO LOOP UNTIL) Procédures et fonctions Manipulation d objets complexes Mais ce qui est intéressant dans la programmation VBA, c est d exploiter l environnement de l application ellemême, qu il s agisse du tableur, de ses classeurs, feuilles de calcul et cellules, ou de la base de données, des formulaires et des curseurs. Tous ces éléments sont accessibles grâce aux objets de l application, chacun offrant de nombreuses propriétés et méthodes utilisables pour les exploiter, paramétrer ou modifier. On les manipule selon la syntaxe suivante : NomObjet.nomMéthode Par exemple : Range("C12").Select I Principes et démarche 1.1 Organisation du code, portée des informations Lorsque l on programme, il est de bon ton d organiser son code de manière à le rendre lisible, simple à modifier et adapté à une réutilisation. Procédures et fonctions, modules Pour cela, on utilise les différents éléments de l interface de programmation : Procédures et fonctions : elles sont définies par le programmeur, pour une réutilisation à divers endroits de l application. Il y a deux étapes : la déclaration, qui décrit les actions qui seront activées lorsqu on y aura recours, et l utilisation qui est l appel à ce code depuis un autre endroit de l application. Procédures événementielles : elles définissent les actions menées lors d une action de l utilisateur (clic de souris, choix dans une liste, modification d une zone de texte, etc). elles portent le nom de l objet cible de l intervention, et l action sur laquelle il réagit : par exemple, boutonok_clic, ListeClients_Change, etc. Modules : ils permettent de regrouper au sein d une même page un ensemble de portions de codes (procédures et fonctions, ainsi que les déclarations de variables) liées logiquement. Les Document1 Serge GUERINET Page 1
éléments (variables et procédures/fonctions) utilisables dans l ensemble de l application sont déclarés dans des modules avec une portée publique. Formulaires et modules : chaque formulaire est associé à un module qui contiendra toutes les procédures événementielles associées aux objets graphiques (contrôles). Les éléments qui y sont définis ne sont pas utilisables au delà de ce module (pour d autres formulaires par exemple) Portée Lorsque l on déclare une variable, une procédure ou une fonction, celle ci n est pas utilisable partout dans une application. En VB, la portée est définie comme suit : Un élément déclaré avec Dim ou Private : il existe dans la procédure/fonction ou dans le module où il est déclaré Un élément préfixé par Public : il est accessible à travers toute l application 1.2 L environnement de programmation VBA Pour accéder à l environnement de programmation, on passera par le menu ou bien en associant une procédure événementielle par le générateur de code : clic droit sur un objet, créer code événement puis choisir dans la fenêtre ci contre. On obtient alors l écran ci dessous. Objets du projet VBA (version Access) : Modules des Formulaires et modules utilisateurs Propriétés des objets des interfaces graphiques Objets du projet VBA (version Excel) : Modules du modèle Modules des feuilles de calcul Formulaires (interface et module) modules utilisateur s Code des différentes procédures et événementielles et des fonctions et procédures de l utilisateur Document1 Serge GUERINET Page 2
La boîte à outils Icône Nom Usage Pointeur pour sélectionner les objets ou Label ou étiquette Zone de texte Liste modifiable ou combo Liste Groupe d option Case à cocher bouton radio bouton bascule : Bouton de commande Multipages Image Assistant Sous formulaire Saut de page Ligne Cadre Cadres d objets Barre de défilement (ou scrollbar) Toupie (ou SpinButton) Onglet 1.3 Démarche pour le codage Permet l affichage d informations sur un formulaire (titres, intitulé des zones, résultats, etc) Saisie d informations choix parmi des valeurs prédéfinies (une liste apparaît lorsque l on clique sur la flèche à droite). Peut être complétée par la saisie Choix parmi des valeurs prédéfinies (barre de défilement pour visualiser tout le contenu) Permet de regroupe des cases à cocher ou des boutons radio pour choisir parmi plusieurs options. La valeur du groupe est définie par la valeur du bouton ou de la case coché Prise seule, permet de valider ou non une option. Dans un groupe d option, permet de choisir une ou plusieurs valeur parmi plusieurs Pris seul, permet d activer une option. Dans un groupe de contrôle, permet de choisir une seule valeur parmi plusieurs Active ou désactive une option. Peut jouer le même rôle qu une case à cocher Permet le lancement d une action déterminée Permet l affichage alternatif des contrôles présent sur les différentes pages. Equivalent d un objet à onglet. Permet l insertion d images sur un formulaire Spécifiques à Access Si activé (c est un bouton bascule), lancera l assistant lors de l insertion d un contrôle sur le formulaire Permet l insertion de données liées à une autre table que celle du formulaire en cours (par exemple les commandes d un client) Permet de scinder un formulaire en n en faisant apparaître qu une partie et en passant d une partie à l autre par des boutons de commande Permet de tracer des lignes sur une interface Permet de tracer un cadre sur une interface (pour l organisation de l information) Permet d incorporer des objets complexes (multimédia, flash, tableur, etc) de manière indépendante (l objet insérer est recopier dans le formulaire) ou dépendante (l objet existe sur le disque et est modifié directement) Spécifiques à Excel Barre de défilement pour faire évoluer une information (ou tout le contenu d un formulaire) par programmation (passer au client suivant par exemple) Permet de faire évoluer une information en par programmation (augmenter un compteur, choisir le mois, etc) Permet l affichage alternatif des contrôles présent sur les différents onglets (tabs en anglais) Langage extrêmement riche dans ses options, le VBA ne peut être maîtrisé dans sa totalité, notamment pour toutes les fonctions permettant de réutiliser dans le code l ensemble des actions accessibles à travers les menus des outils bureautiques. La démarche habituelle pour pouvoir reproduire l une de ces actions lorsque l on en a oublié la syntaxe consiste donc à faire générer le code automatiquement par VB Document1 Serge GUERINET Page 3
Pour Excel : en créant une Macro(menu Outils/Macro/Nouvelle Macro). On ouvre ensuite l éditeur Visual Basic et l on retrouve en langage VBA le code à adapter Pour Access : créer une Macro commande depuis la fenêtre de la base de données (on utilise alors des actions par le biais de menus déroulants), puis à convertir ces éléments en langage VBA (Menu Outils/Macro/Convertir les macros en Visual Basic) Bien entendu, on s appropriera progressivement le langage et on codera directement avec celui ci. II ENVIRONNEMENT EXCEL Sous Excel, la partie spécifique de VBA porte sur la manipulation des classeurs, feuilles de calcul et cellules. Ces objets proposent de nombreuses méthodes. Pour la gestion des formulaires, on se reportera à la partie Access. Objets Excel Les objets Excel et leur propriétés OBJET CONTENU Exemples d utilisation Windows Représente la liste des classeurs ouverts Windows("nomClasseur.xls").Select Windows(2).Activate ActiveWorkbook Le classeur actuel ActiveWorkbook.Save Sheets Liste l ensemble des feuilles de calcul d un classeur Sheets("Feuil1").Select Sheets(4).Activate ActiveSheet La feuille de calcul actuelle ActiveSheet.Copy Cells l ensemble des cellules d une feuille de calcul Cells.Select Cells(1,2).Paste Cellule B1 ActiveCell La cellule active ActiveCell.Paste Range Décrit une cellule ou une plage de cellules Range("C1").Text Range("Cellule_nommée").Select Range("A1:C9").Formula="" Méthodes associées Associées à ces objets, de nombreuses méthodes permettent d en modifier la valeur, d accéder au contenu, etc. Voici les plus courantes, avec leur champ d application (objets auxquels elles s appliquent). Elles sont présentées dans l ordre où on les utilise habituellement. Méthode Rôle Windows ActiveWorkboo k Sheets Activate Met l objet au premier plan X X X Select Sélectionne l un des objets parmi plusieurs pour le faire X X X X devenir l élément actif Copy Reproduit le contenu dans le presse papier X X X X X Paste Recopie le contenu du presse papier X X X Formula Définit ou renvoie la formule de calcul (ou le contenu X X lorsqu il s agit d une valeur) d une cellule ou d une plage de cellules Text Retourne l information affichée dans une cellule ou une plage X X de cellules (ne permet pas de connaître la formule de calcul) D autres méthodes permettent de modifier la mise en forme ou d utiliser les différentes options des menus de Excel.. ActiveSheet Cells ActiveCell Range Document1 Serge GUERINET Page 4
III ENVIRONNEMENT ACCESS Parmi les éléments significatifs qu offre la programmation VBA en Access, on trouvera les éléments des formulaires, ainsi que toutes les structures d accès aux différentes tables. 3.1 Formulaires L interactivité avec l utilisateur passe par la création de formulaires. Ceux ci peuvent être paramétrés par le biais des Propriétés de l interface graphique, ou manipulés dans la programmation VBA. Les différents contrôles sont ensuite manipulés par les méthodes adaptées ou lorsque des événements sont générés par l utilisateur ou l application. Propriétés des objets Ci dessous sont présentées les principales rubriques sur lesquelles il peut être intéressant d intervenir, avec leur nom de propriété dans l interface graphique, leur équivalent en VBA et leur rôle. Nom Propriété Nom VBA Rôle Tous les contrôles : formulaires, zones de saisies, étiquettes, etc Name ou Nom* Name Définit ou renvoie le nom d un objet Source Contrôle* ControlSource Définit ou renvoie la table ou le champ de table associé à un objet (zone de texte, formulaire, liste, etc) Visible Visible Indique si un objet est affiché à l écran ou masqué Activé* ou Enabled Enabled Indique si un objet est accessible à l utilisateur ou s il est désactivé Objets de saisie : zone de texte, liste, boutons Text Text Définit ou renvoie le contenu affiché d un objet (zone de texte ou liste) Caption Caption Définit ou renvoie le texte affiché dans une étiquette List List Définit ou renvoie les valeurs contenues dans une liste déroulante (pour Excel seulement) Origine Source* RowSourceType Définit ou renvoie la façon dont une liste est alimentée (par une table/requête, par une liste de valeur, etc) Contenu* ou RowSource RowSource Définit ou renvoie le contenu effectif d une liste en fournissant une liste de valeurs ou la requête qui l alimente Value Value Définit ou renvoie la valeur effective d un objet (liste, groupe d option, bouton d option, etc). Pour les listes, Value peut être différent de l information affichée. Groupes d option et bouton d option Valeur Contrôle OptionValue Définit ou renvoie la valeur associée à un bouton d option ou une case à cocher (qui sera affectée à un groupe de contrôle si ce bouton est sélectionné) Conteneurs : Formulaires et MultiPages et Onglets Controls( ) Liste des contrôles présents sur le conteneur Pages( ) Liste des pages (ou onglets) présentes sur un objet Multipages Tabs( ) Liste des onglets d un objet à Onglets * Pour Access seulement Méthodes Les méthodes sont les actions directement applicables sur un objet spécifique, comme une demande d affichage d un formulaire ou de réactualisation du contenu d une zone. En voici quelques unes très souvent utilisées. On les utilise comme suit : nomobjet.nomméthode [liste_paramètres_éventuels], sauf cas particuliers Méthode Rôle End Met fin à l application. Ne s applique pas à un objet. Hide Masque un formulaire Quit Quitte le programme (Excel ou Access). Ne s applique pas à un objet Refresh Rafraîchit un écran ou un contrôle, par exemple après une modification de couleur ou un changement de contenu Requery Recalcule le contenu d une liste, en particulier lorsqu elle SetFocus Positionne le curseur sur l objet Show Permet l affichage d un formulaire Unload Ferme le formulaire et libère la mémoire. S utilise comme suit : Unload nomformulaire Document1 Serge GUERINET Page 5
Evénements Les événements sont les actions à prendre en compte lorsque l utilisateur interagit avec le programme, comme par exemple lorsqu il clique sur un bouton de commande ou qu il modifie le contenu d une zone de saisie. Evénement Explication Activate Lorsque le formulaire est remis au premier plan Change Lorsque l on modifie le contenu d une zone de texte ou que l on sélectionne une information dans une liste Clic Lorsque l on clique avec la souris GetFocus Lorsqu un contrôle obtient le curseur de saisie Load Au chargement du formulaire LostFocus Lorsqu un contrôle perd le curseur de saisie 3.2 Les curseurs en programmation Avec les formulaires Access, il est très simple de manipuler les données d une table, voire les dépendances entre deux tables grâce aux sous formulaires. Mais dès que l on souhaite intervenir sur une (ou plusieurs) autre(s) table(s) que celle associée au formulaire, il n est plus possible de le faire simplement : on devra alors ouvrir d autres formulaires, multiplier les sousformulaires ou recourir à de la programmation. Curseur Dans ce dernier cas, l outil mis à disposition du programmeur est nommé curseur, qui permet d interroger la base de données et d exploiter les résultats fournis. Pour VBA, le curseur est représenté par deux objets : QueryDef : il s agit en fait de l équivalent de la fenêtre requête proposée par l interface graphique de Access, dans laquelle on saisira le code de toute requête SQL (SELECT, INSERT, UPDATE, DELETE), et que l on pourra enregistrer en lui affectant un nom. On parle parfois d une vue pour caractériser ce composant. RecordSet : Cet objet permet d obtenir en mémoire le résultat d une requête SELECT et d en parcourir les lignes en exploitant les différents champs. Précaution Sous Access 2000 Pour pouvoir exploiter les bases de données, Access propose deux modes : ADO (ActiveX Data Object) qui est l ancienne version, et DAO (Data Access Object) qui est la plus récente, la plus souple et la plus efficace. Les versions Access 2000 (et antérieures) sont paramétrées selon l ancien mode, mais peuvent être modifiées pour s appuyer sur DAO. Pour cela, on suivra la procédure suivant. Depuis l éditeur Visual Basic, on choisira le menu Outils/Références : On décoche l option par défaut faisant référence à ADO On active l option la plus récente de DAO Programmation VBA Ces objets doivent être associés à une base de données, déclarée comme suit : Dim nombase as DataBase On peut ensuite les créer (on se contentera évidemment de l un des objets en fonction de ses besoins) Dim crsclient as RecordSet exple pour une requête de parcours des clients CrsClient = nombase.openrecordset("select * from client ", type_ouverture) Dim inserclient as QueryDef exple pour une requête d insertion qui n a pas besoin d être conservée inserclient = nombase.createquerydef("", "insert into client values ( ) ; ") pas de nom Dim majrappels as QueryDef exple pour une requête de MAJ qui devra être rappelée régulièrement Document1 Serge GUERINET Page 6
majrappels = nombase.createquerydef("maj Rappels Acheves","update Rappels set regle = true ") la requête sera enregistrée avec le nom [MAJ Rappels Acheves] Le type d ouverture d un curseur peut être : dbopensnapshot : la table est copiée en mémoire, il ne peut y avoir de modification dbforwardonly : la table ne peut être parcourue qu en passant aux enregistrements suivants (pas de parcours arrière) dbdynaset ou dbdynamic : la table est ouverte en lecture/écriture, elle peut être parcourue en avant ou en arrière On pourra parcourir le curseur pour afficher les informations parcours le curseur tant que l on n est pas à la fin Do While not curseur.eof affiche le champ nommé «Cli_Nom» et le champ n 3 Window.Print crsclient.fields("cli_nom") & crsclient.fields(3) Loop Méthodes d un curseur (RecordSet) Voici quelques une des principales méthodes : Evénement Explication Exécution des requêtes Execute* Exécute la requête SQL associée au curseur Requery Réexécute la requête SQL associée au curseur Exploitation des lignes Recordcount Fields(nom_Champ) Ou Fields(n _Champ) Indique le nombre de lignes du curseur Retourne la valeur du champ indiqué par son nom ou son numéro d ordre dans l enregistrement en cours. Déplacements MoveNext Se déplace en avant dans les lignes du curseur MoveFirst Se positionne sur le premier enregistrement MoveLast Se positionne sur le dernier enregistrement MovePrevious Revient sur l enregistrement précédent EOF Renvoie un booléen pour indiquer si l on a atteint la fin du curseur Fermeture du curseur Close Ferme l objet curseur * s applique aussi directement à un objet DataBase ou à un objet QueryDef Document1 Serge GUERINET Page 7
3.3 DoCmd En plus des méthodes des objets graphiques et des curseurs, de nombreuses manipulations sont accessibles par l intermédiaire de l objet DoCmd (pour les versions 200 et antérieures) ou la commande DoCmd (pour 2003 et postérieures). La différence entre les deux (objet ou commande) repose sur la syntaxe d appel : Version objet : DoCmd.nomOpération [Liste paramètres éventuels] Version commande : DoCmd nomopération [Liste paramètres éventuels] Parmi les opérations à retenir, on trouvera : Opération Paramètres Action réalisée Close Ferme le formulaire en cours GoToControl Nom_contrôle Positionne le curseur de la souris sur le contrôle en paramètre. Utile pour les recherches Findrecord (on doit se positionner sur le champ sur lequel porte la recherche FindRecord ExpressionCherchée Retrouve un enregistrement de la table liée au formulaire qui a une valeur égale à l expression en paramètre sur le champ lié au contrôle pointé par le curseur de saisie FindNext Trouve le prochain enregistrement répondant à la dernière exécution Findrecord OpenForm Nom_formulaire Ouvre le formulaire nommé en paramètre OpenQuery Nom_Requête Ouvre une requête enregistrée et l exécute Quit Quitte Access RunSQL Requête_SQL Exécute la requête en paramètre (par exemple un insert) sans passer par un objet curseur Document1 Serge GUERINET Page 8