Sous-programme Excel VBA : comment appeler Sub dans VBA avec exemple

⚡ Résumé intelligent

Une sous-routine VBA Excel regroupe un bloc de code qui exécute une tâche sans renvoyer de valeur. Cette page aborde les règles de nommage, la syntaxe des sous-routines, l'appel d'une sous-routine à partir d'un bouton de commande et la différence entre une sous-routine et une fonction.

  • 📦 Définition: Une sous-routine exécute une tâche spécifique et ne renvoie aucune valeur au code qui l'a appelée.
  • ♻️ Réutilisabilité: Une même sous-routine peut être appelée plusieurs fois depuis n'importe quel endroit du projet.
  • 🔤 Règles de dénomination : Un nom ne contient pas d'espaces, commence par une lettre ou un trait de soulignement, et n'est jamais un mot-clé VBA.
  • 🧾 syntaxe: La procédure Private Sub name(ByVal arg As String) ouvre le bloc et la procédure End Sub le ferme.
  • 🇧🇷 Appel: L'événement Click d'un bouton de commande appelle la sous-routine et lui transmet ses arguments.
  • ▶ ️ Exécution directe : La touche F5, la boîte de dialogue Macros ou le mot-clé Appel permettent tous d'exécuter une sous-routine sans bouton.
  • (I.e. Sous-fonction : Choisissez une fonction lorsqu'une valeur doit être renvoyée, sinon choisissez une sous-routine.

Sous-programme Excel VBA

Qu’est-ce qu’un sous-programme en VBA ?

A Sous-programme en VBA est un morceau de code qui exécute une tâche spécifique décrite dans le code mais ne renvoie ni résultat ni valeur. Les sous-programmes sont utilisés pour diviser de gros morceaux de code en petites parties gérables. Les sous-programmes peuvent être rappelés plusieurs fois depuis n'importe où dans le programme.

Supposons que vous ayez créé une interface utilisateur avec des zones de texte pour accepter les données saisies par l'utilisateur. Vous pouvez créer un sous-programme qui efface le contenu des zones de texte. Un sous-programme d'appel VBA est approprié dans un tel scénario car vous ne souhaitez renvoyer aucun résultat.

Pourquoi utiliser les sous-programmes

  • Divisez le code en petit code gérable: Un programme informatique moyen comporte des milliers et des milliers de lignes de code source. Cela introduit de la complexité. Les sous-programmes aident à résoudre ce problème en décomposant le programme en petits morceaux de code gérables.
  • Code réutilisabilité. Disons que vous avez un programme qui doit accéder à la base de données, presque toutes les fenêtres du programme devront interagir avec la base de données. Au lieu d'écrire du code séparé pour ces fenêtres, vous pouvez créer une fonction qui gère toutes les interactions avec la base de données. Vous pouvez ensuite l'appeler depuis la fenêtre de votre choix.
  • Les sous-programmes et les fonctions sont auto-documentés. Disons que vous avez une fonction calculateLoanInterest et une autre qui dit connectToDatabase. En regardant simplement le nom du sous-programme/de la fonction, le programmeur sera en mesure de savoir ce que fait le programme.

Avant d'en écrire un, le compilateur s'attend à ce que le nom suive un petit ensemble de règles.

Règles de dénomination des sous-programmes et des fonctions

Pour utiliser des sous-programmes et des fonctions, il existe un ensemble de règles qu'il faut suivre.

  • Un nom de sous-programme ou de fonction d'appel VBA ne peut pas contenir d'espace
  • Un sous-appel ou un nom de fonction Excel VBA doit commencer par une lettre ou un trait de soulignement. Il ne peut pas commencer par un chiffre ou un caractère spécial
  • Un nom de sous-programme ou de fonction ne peut pas être un mot-clé. Un mot-clé est un mot qui a une signification particulière dans VBA. Des mots comme Private, Sub, Function et End, etc. sont tous des exemples de mots-clés. Le compilateur les utilise pour des tâches spécifiques.

Une fois un nom valide choisi, la déclaration elle-même suit un modèle fixe.

Syntaxe des sous-programmes VBA

Vous devrez activer l'onglet Développeur dans Excel pour suivre cet exemple. Si vous ne savez pas comment activer l'onglet Développeur, lisez le tutoriel sur Contrôles VBA dans Excel

ICI dans la syntaxe,

Private Sub mySubRoutine(ByVal arg1 As String, ByVal arg2 As String)
    'do something
End Sub

Explication de la syntaxe

Code Action
  • « Sous-privé mySubRoutine (...) »
  • Ici, le mot-clé « Sub » est utilisé pour déclarer un sous-programme nommé « mySubRoutine » et démarrer le corps du sous-programme.
  • Le mot-clé Private est utilisé pour spécifier la portée du sous-programme
  • « ByVal arg1 comme chaîne, ByVal arg2 comme chaîne » :
  • Il déclare deux paramètres de type de données chaîne arg1 et arg2
  • "Fin du sous-marin"
  • « End Sub » est utilisé pour terminer le corps du sous-programme

Le sous-programme suivant accepte le prénom et le nom et les affiche dans une boîte de message.

Nous allons maintenant programmer et exécuter cette sous-procédure. Voyons ça.

Comment appeler Sub dans VBA

Vous trouverez ci-dessous un processus étape par étape pour appeler Sub dans VBA :

  1. Concevez l'interface utilisateur et définissez les propriétés des contrôles utilisateur.
  2. Ajouter le sous-programme
  3. Écrivez le code d'événement de clic pour le bouton de commande qui appelle le sous-programme
  4. Tester l'application

Étape 1) Interface utilisateur

Concevez l'interface utilisateur comme indiqué dans l'image ci-dessous.

Comment appeler Sub dans VBA

Définissez les propriétés suivantes. Les propriétés que nous définissons :

Ratio S / N Contrôle Propriétés Valeur
1 Bouton de commande1 Nom btnDisplayFullName
2 Légende Sous-programme Nom complet

Votre interface devrait maintenant ressembler à ceci.

Comment appeler Sub dans VBA

Étape 2) Ajouter un sous-programme

  1. Appuyez sur Alt + F11 pour ouvrir la fenêtre de code
  2. Ajoutez le sous-programme suivant
Private Sub displayFullName(ByVal firstName As String, ByVal lastName As String)
    MsgBox firstName & " " & lastName
End Sub

ICI dans le code,

Code Action
  • « Sous-affichage privéFullName(…) »
  • Il déclare un sous-programme privé displayFullName qui accepte deux paramètres de chaîne.
  • "ByVal firstName sous forme de chaîne, ByVal lastName sous forme de chaîne"
  • Il déclare deux variables de paramètre firstName et lastName
  • MsgBox Prénom nom de famille"
  • Il appelle le MsgBox fonction intégrée pour afficher une boîte de message. Elle passe ensuite les variables 'firstName' et 'lastName' comme paramètres.
  • L'esperluette « & » est utilisée pour concaténer les deux variables et ajouter un espace vide entre elles.

Étape 3) Appel du sous-programme

Appel du sous-programme à partir de l’événement de clic du bouton de commande.

  • Faites un clic droit sur le bouton de commande comme indiqué dans l'image ci-dessous. Sélectionnez Afficher Code.
  • L'éditeur de code s'ouvrira

Comment appeler Sub dans VBA

Ajoutez le code suivant dans l’éditeur de code pour l’événement click du bouton de commande btnDisplayFullName.

Private Sub btnDisplayFullName_Click()
    displayFullName "John", "Doe"
End Sub

Votre fenêtre de code devrait maintenant ressembler à ceci

Comment appeler Sub dans VBA

Enregistrez les modifications et fermez la fenêtre de code.

Étape 4) Tester le code

Dans la barre d'outils du développeur, désactivez le mode conception. Comme indiqué ci-dessous.

Comment appeler Sub dans VBA

Étape 5) Cliquez sur le bouton de commande 'FullName Subroutine'.

Vous obtiendrez les résultats suivants

Comment appeler Sub dans VBA

Téléchargez le fichier Excel ci-dessus. Code

Un bouton est pratique, mais ce n'est pas la seule façon de lancer une sous-routine, et pendant le développement, c'est rarement la plus rapide.

Comment exécuter une sous-routine sans bouton

Pendant que vous écrivez encore du code, ajouter un contrôle à la feuille uniquement pour tester une sous-routine est une perte de temps. VBA propose quatre autres méthodes pour exécuter une sous-routine, chacune étant plus adaptée à une étape différente du cycle de développement.

  • Appuyez sur F5 dans l'éditeur : Placez le curseur n'importe où à l'intérieur de la procédure Sub et appuyez sur F5. Elle s'exécute immédiatement. Cela fonctionne uniquement lorsque la procédure Sub ne prend aucun argument, car VBA n'a aucune valeur à fournir.
  • Passez à l'étape suivante avec F8 : Le même programme s'exécute ligne par ligne, ce qui vous permet d'observer l'évolution de chaque variable dans la fenêtre Variables locales. Utilisez cette méthode lorsqu'un résultat est erroné et que vous devez en identifier la cause.
  • Utilisez la boîte de dialogue Macros : Dans l'onglet Développeur, cliquez sur Macros, sélectionnez le nom, puis cliquez sur Exécuter. Seules les procédures publiques sans arguments apparaissent dans cette liste ; c'est pourquoi une procédure auxiliaire est généralement déclarée privée.
  • Appelez-le depuis un autre sous-forum : C'est la méthode utilisée pour toute procédure Sub qui prend des arguments, et celle sur laquelle repose le bouton de commande ci-dessus.

La dernière option admet deux formes acceptables : écrire le nom suivi des arguments nus, ou utiliser explicitement le mot-clé Call, mais la règle des crochets diffère.

Sub RunTheGreeting()
    ' Form 1: no Call keyword, no brackets
    displayFullName "John", "Doe"

    ' Form 2: Call keyword, brackets required
    Call displayFullName("Jane", "Roe")
End Sub

Ces deux lignes font exactement la même chose. Mélanger les deux formes, en écrivant des parenthèses sans le mot-clé Call, est la cause la plus fréquente de l'erreur de compilation « Expected: = » lorsqu'une fonction Sub prend plusieurs arguments.

Différence entre une procédure et une fonction en VBA

En VBA, les procédures Sub et Function sont les deux types de procédures les plus courants, et les débutants font souvent le mauvais choix. La question qui permet de trancher est simple : le code appelant a-t-il besoin d’une valeur en retour ?

Fonctionnalité Sol Fonction
Renvoie une valeur Non Oui, attribué au nom de la fonction
Déclaré avec Sous … Fin Sous Fonction …Fin de la fonction
Appelé comme Une déclaration qui se suffit à elle-même Partie d'une expression, par exemple x = myFunc(2)
Utilisable dans une cellule de feuille de calcul Non Oui, en tant que fonction définie par l'utilisateur
Utilisation typique Mettre en forme une feuille, effacer les données saisies, afficher un message Calculer un total, convertir une valeur, rechercher des données

Utilisez une procédure Sub lorsque le code agit sur le classeur, et une Fonction VBA lorsque le code produit une réponse qui est ensuite utilisée par un autre élément.

FAQ

Une procédure privée (Private Sub) ne peut être appelée que depuis le module qui la déclare. Une procédure publique (Public Sub) est visible par tous les modules du projet et est la seule à apparaître dans la boîte de dialogue Macros.

ByVal transmet une copie, empêchant ainsi la sous-routine de modifier la variable appelante. ByRef transmet la variable elle-même, rendant toute modification visible pour l'appelant. ByRef est le comportement par défaut lorsqu'aucun de ces mots-clés n'est spécifié.

Utilisez l'instruction Exit Sub. Elle interrompt la procédure à ce point et rend le contrôle à l'appelant, ce qui est utile pour quitter prématurément en cas d'échec d'un test de validation.

Oui. Collez la macro : un assistant IA regroupe les lignes associées, suggère un nom descriptif pour chaque nouvelle procédure et réécrit le code original sous forme d’une courte séquence d’appels. Testez le résultat sur une copie du classeur.

Oui. Indiquez-lui le texte d'erreur et la ligne appelante, et un assistant IA identifiera les causes telles que des parenthèses utilisées sans le mot-clé Call, un nombre d'arguments incorrect ou un type de données incompatible, puis fournira la ligne corrigée.

Résumez cet article avec :