Comment utiliser la boîte de dialogue Insérer une fonction dans Excel 2016 VBA - dummies

La boîte de dialogue Insérer une fonction est un outil Excel pratique qui vous permet de choisir une fonction de feuille de calcul VBA dans une liste et vous invite à entrer ses arguments. Vos fonctions de feuille de calcul personnalisées apparaissent également dans la boîte de dialogue Insérer une fonction. Les fonctions personnalisées apparaissent dans la catégorie Défini par l'utilisateur.

Les procédures de fonction définies avec le mot-clé Private n'apparaissent pas dans la boîte de dialogue Insérer une fonction. Par conséquent, si vous écrivez une procédure Function conçue pour être utilisée uniquement par d'autres procédures VBA (mais pas dans des formules), vous devez déclarer la fonction comme privée.

Affichage de la description de la fonction

La boîte de dialogue Insérer une fonction affiche une description de chaque fonction intégrée. Mais comme vous pouvez le voir, une fonction personnalisée affiche le texte suivant comme description: Aucune aide disponible.

Par défaut, la boîte de dialogue Insérer une fonction ne fournit pas de description pour les fonctions personnalisées.

Pour afficher une description significative de votre fonction personnalisée dans la boîte de dialogue Insérer une fonction, effectuez quelques étapes supplémentaires (non intuitives):

1. Activer une feuille de calcul dans le classeur contenant la fonction personnalisée.

2. Choisissez Développeur → Code → Macros (ou appuyez sur Alt + F8).

   La boîte de dialogue Macro apparaît.

3. Dans le champ Nom de la macro, tapez le nom de la fonction.

   Notez que la fonction n'apparaît pas dans la liste des macros; vous devez taper le nom.

4. Cliquez sur le bouton Options.

   La boîte de dialogue Options de macro apparaît.

5. Dans le champ Description, tapez une description de la fonction.

6. Cliquez sur OK.

7. Cliquez sur Annuler.

   Maintenant, la boîte de dialogue Insérer une fonction affiche la description de votre fonction.

   

   La fonction personnalisée affiche maintenant une description.

Les fonctions personnalisées sont répertoriées par défaut dans la catégorie Défini par l'utilisateur. Pour ajouter une fonction à une catégorie différente, vous devez utiliser VBA. Cette instruction, lorsqu'elle est exécutée, ajoute la fonction TopAvg à la catégorie Math & Trig (catégorie 3):

Application. MacroOptions Macro: = "TopAvg", Catégorie: = 3

Vérifiez le système d'aide pour les autres numéros de catégorie.

Vous devez exécuter cette instruction une seule fois. Après l'avoir exécuté (et sauvegardé le classeur), le numéro de catégorie est assigné en permanence à la fonction.

Ajout de descriptions d'argument

Lorsque vous accédez à une fonction intégrée à partir de la boîte de dialogue Insérer une fonction, la boîte de dialogue Arguments de la fonction affiche les descriptions des arguments.

Par défaut, la boîte de dialogue Arguments de la fonction affiche les descriptions des arguments de fonction pour les fonctions intégrées uniquement.

Dans le passé, il n'était pas possible d'ajouter des descriptions d'argument. Mais à partir d'Excel 2010, Microsoft a enfin implémenté cette fonctionnalité. Vous fournissez des descriptions d'argument en utilisant la méthode MacroOptions. Voici un exemple qui ajoute des descriptions pour les arguments utilisés par la fonction TopAvg:

Sub AddArgumentDescriptions () Application. MacroOptions Macro: = "TopAvg", _ ArgumentDescriptions: = _ Array ("Plage qui contient les valeurs", _ "Nombre de valeurs à la moyenne") End Sub

Vous devez exécuter cette procédure une seule fois. Après l'exécution, les descriptions d'argument sont stockées dans le classeur et sont associées à la fonction.

Notez que les descriptions d'argument apparaissent en tant qu'arguments pour la fonction Array. Vous devez utiliser la fonction Array même si vous affectez une description à une fonction qui n'a qu'un seul argument.