Fonction MsgBox

Dans une base de données de bureau Access, la MsgBox fonction affiche un message dans une boîte de dialogue, attend que l’utilisateur sélectionne un bouton, puis renvoie un Integer qui indique quel bouton l’utilisateur a sélectionné.

Syntaxe

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

La MsgBox syntaxe de la fonction contient les arguments suivants :

Argument	Description
prompt	Obligatoire. Expression de chaîne affichée comme message dans la boîte de dialogue. La longueur maximale de est d’environ prompt 1 024 caractères, en fonction de la largeur des caractères utilisés. S’il prompt comporte plusieurs lignes, vous pouvez les séparer à l’aide d’un caractère de retour chariot (Chr(13)), d’un saut de ligne (Chr(10)) ou d’une combinaison retour chariot et saut de ligne (Chr(13) & Chr(10)) entre chaque ligne.
buttons	Facultatif. Expression numérique qui est la somme des valeurs qui spécifient 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 elle est omise, la valeur par défaut est buttons0.
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 apparaît dans la barre de titre.
helpfile	Facultatif. Expression de chaîne qui identifie le fichier d’aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si helpfile est fourni, context doit également être fourni.
context	Facultatif. Expression numérique qui est le numéro de contexte d’aide attribué à la rubrique d’aide appropriée par l’auteur de l’aide. Si context est fourni, helpfile doit également être fourni.

Paramètres

Les buttons paramètres d’argument sont les suivants :

Constante	Valeur	Description
vbOKOnly	0	Affichage OK uniquement.
vbOKCancel	1	Afficher OK et Annuler.
vbAbortRetryIgnore	2	Afficher Abandonner, Réessayer et Ignorer.
vbYesNoCancel	3	Afficher Oui, Non et Annuler.
vbYesNo	4	Afficher Oui et Non.
vbRetryCancel	5	Afficher, réessayer et annuler.
vbCritical	16	Afficher l’icône Message critique .
vbQuestion	32	Affichez l’icône Requête d’avertissement .
vbExclamation	48	Afficher l’icône du message d’avertissement .
vbInformation	64	Afficher l’icône Message d’information .
vbDefaultButton1	0	Définir le premier bouton comme bouton par défaut.
vbDefaultButton2	256	Définir le deuxième bouton comme bouton par défaut.
vbDefaultButton3	512	Définir le troisième bouton comme bouton par défaut.
vbDefaultButton4	768	Définir le quatrième bouton comme bouton par défaut.
vbApplicationModal	0	Application modale. L’utilisateur doit répondre à la boîte de message avant de continuer à travailler dans l’application active.
vbSystemModal	4096	Modal système. Toutes les applications sont suspendues jusqu’à ce que l’utilisateur réponde à la boîte de message.
vbMsgBoxHelpButton	16384	Ajoutez un bouton d’aide dans la zone de message.
VbMsgBoxSetForeground	65536	Spécifier la fenêtre de la boîte de message comme fenêtre de premier plan.
vbMsgBoxRight	524288	Aligner le texte à droite
vbMsgBoxRtlReading	1048576	Faites apparaître le texte avec une lecture de droite à gauche sur les systèmes hébreu et arabe.

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

Valeurs de retour

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

Remarques

Lorsque les deux helpfile et context sont fournis, l’utilisateur peut appuyer sur F1 dans Windows ou sur l’aide dans macOS pour afficher la rubrique d’aide qui correspond contextà . Certaines applications hôtes, telles que Microsoft Excel, ajoutent aussi automatiquement un bouton d’aide à la boîte de dialogue.

Si la boîte de dialogue affiche un bouton Annuler , appuyer sur Échap a le même effet que sélectionner Annuler. Si la boîte de dialogue contient un bouton d’aide , une aide contextuelle est fournie pour la boîte de dialogue. Toutefois, aucune valeur n’est renvoyée tant que l’utilisateur n’a pas sélectionné l’un des autres boutons.

Exemple

Cet exemple utilise la MsgBox fonction pour afficher un message d’erreur critique dans une boîte de dialogue avec les boutons Oui et Non . Le bouton Non est spécifié comme réponse par défaut. La valeur renvoyée par la MsgBox fonction dépend du bouton que l’utilisateur sélectionne. Cet exemple suppose qu’il DEMO.HLP s’agit d’un fichier d’aide qui contient une rubrique avec un numéro de contexte d’aide égal à 1000.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
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