Fonction MsgBox

  • Article

Affiche un message dans une boîte de dialogue, attend que l’utilisateur clique sur un bouton et renvoie un Entier indiquant sur quel bouton l’utilisateur a cliqué.

Remarque

Vous voulez développer des solutions qui étendent l’expérience Office sur plusieurs plateformes ? Découvrez le nouveau modèle de compléments Office. Les compléments Office ont un encombrement réduit par rapport aux compléments et solutions VSTO. Vous pouvez les créer à l’aide de pratiquement n’importe quelle technologie de programmation web, telle que HTML5, JavaScript, CSS3 et XML.

Syntaxe

MsgBox (prompt, [ buttons, ] [ title, ] [ helpfile, context ])

La syntaxe de la fonction MsgBox comprend les arguments nommés suivants :

Élément Description
prompt Obligatoire. Expression de chaîne affichée en tant que message dans la boîte de dialogue. La longueur maximale de prompt est d’environ 1 024 caractères, en fonction de la largeur des caractères utilisés. Si prompt est constitué de plus d’une ligne, vous pouvez séparer les lignes en utilisant un caractère retour chariot (Chr(13)), un caractère de saut de ligne (Chr(10)), ou une combinaison de caractères retour chariot et saut de ligne ((Chr(13) & (Chr(10)) entre chaque ligne.
buttons Facultatif. Expression numérique est la combinaison de valeurs spécifiant le nombre et le type de boutons à afficher, le style d'icône à utiliser, l'identité du bouton par défaut et la modalité de la boîte de message. Si cet argument est omis, la valeur par défaut pourbuttons est 0.
title Facultatif. Expression de chaîne affichée dans la barre de titre de la boîte de dialogue. Si vous omettez title, le nom de l’application est placé dans la barre de titre.
helpfile Facultatif. Expression de chaîne indiquant le fichier d’Aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si helpfile est fourni, context doit également être indiqué.
context Facultatif. Expression numérique indiquant le numéro de contexte d’Aide attribué par l’auteur de l’Aide à la rubrique appropriée. Si context est fourni, helpfile doit également être indiqué.

Paramètres

Les paramètres de l’argument boutons sont les suivants :

Constante Valeur Description
vbOKOnly 0 Affiche le boutonOK uniquement.
vbOKCancel 1 Affiche les boutons OK et Annuler.
vbAbortRetryIgnore 2 Affiche les boutonsAbandonner, Réessayer, et Ignorer.
vbYesNoCancel 3 Affiche les boutons Oui, Non et Annuler.
vbYesNo 4 Affiche les boutons Oui et Non.
vbRetryCancel 5 Affiche les boutons Réessayer et Annuler.
vbCritical 16 Affiche l’icôneMessage critique.
vbQuestion 32 Affiche l’icôneRequête d’avertissement.
vbExclamation 48 Affiche l’icôneMessage d’avertissement.
vbInformation 64 Affiche l’icôneMessage d’information.
vbDefaultButton1 0 Le premier bouton est le bouton par défaut.
vbDefaultButton2 256 Le deuxième bouton est le bouton par défaut.
vbDefaultButton3 512 Le troisième bouton est le bouton par défaut.
vbDefaultButton4 768 Le quatrième bouton est le bouton par défaut.
vbApplicationModal 0 Boîte de dialogue modale. L'utilisateur doit répondre au message affiché dans la zone de message avant de pouvoir continuer de travailler dans l'application actuelle.
vbSystemModal 4096 Modal système. Toutes les applications sont interrompues jusqu'à ce que l'utilisateur réponde au message affiché dans la zone de message.
vbMsgBoxHelpButton 16384 Ajoute le boutonAide à la zone de message.
vbMsgBoxSetForeground 65536 Indique la fenêtre de zone de message comme fenêtre de premier plan.
vbMsgBoxRight 524288 Le texte est aligné à droite.
vbMsgBoxRtlReading 1048576 Spécifie que le texte doit apparaître pour être lu de droite à gauche dans les systèmes en Arabe et en Hébreu.

Le premier groupe de valeurs (0-5) décrit le numéro et le type de boutons affichés dans la boîte de dialogue ; le deuxième groupe (16, 32, 48, 64) décrit le style d’icône ; le troisième groupe (0, 256, 512) détermine quel bouton est celui par défaut ; et le quatrième groupe (0, 4096) détermine la modalité de la zone de message. Lorsque vous combinez des numéros pour créer une valeur finale pour l’argument buttons, utilisez un seul numéro de chaque groupe.

Remarque

Ces constantes sont spécifiées par Visual Basic pour Applications dans l’énumération VbMsgBoxStyle . Par conséquent, elles peuvent être utilisées n’importe où dans votre code à la place de valeurs réelles.

Valeurs de retour

Les valeurs de retour sont définies dans l’énumération VbMsgBoxResult .

Constante Valeur Description
vbOK 1 OK
vbCancel 2 Cancel
vbAbort 3 Abandonner
vbRetry 4 Réessayer
vbIgnore 5 Ignore
vbYes 6 Oui
vbNo 7 Non

Remarques

Lorsque helpfile et context sont fournis tous les deux, l’utilisateur peut appuyer sur F1 (Windows) ou AIDE (Macintosh) pour afficher la rubrique d’Aide correspondant à context. Certainesapplications hôtes, par exemple, Microsoft Excel, ajoutent automatiquement un bouton Aide à la boîte de dialogue.

Si la boîte de dialogue affiche un bouton Annuler, appuyer sur la touche ÉCHAP a le même effet que de cliquer sur Annuler. Si la boîte de dialogue contient un boutonAide, une aide contextuelle est fournie pour la boîte de dialogue. Toutefois, aucune valeur n’est renvoyée jusqu'à ce que l’utilisateur clique sur un des autres boutons.

Remarque

Pour spécifier plus que premier argument nommé, vous devez utiliser MsgBox dans une expression. Pour omettre certains arguments de position, vous devez inclure le séparateur de virgule correspondant.

Exemple

Cet exemple utilise la fonctionMsgBox pour afficher un message d’erreur critique dans une boîte de dialogue avec les boutonsOui et Non. Le boutonNon est spécifié en tant que réponse par défaut. La valeur renvoyée par la fonctionMsgBox dépend du bouton choisi par l’utilisateur. Cet exemple part du principe que DEMO.HLP est un fichier d’Aide qui contient un sujet avec un numéro de contexte Aide égal à 1000.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue ?"    ' Define message.
Style = vbYesNo Or vbCritical Or vbDefaultButton2    ' Define buttons.
Title = "MsgBox Demonstration"    ' Define title.
Help = "DEMO.HLP"    ' Define Help file.
Ctxt = 1000    ' Define topic context. 
        ' Display message.
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then    ' User chose Yes.
    MyString = "Yes"    ' Perform some action.
Else    ' User chose No.
    MyString = "No"    ' Perform some action.
End If

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.