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 et retourne un Integer qui indique le bouton sélectionné par l’utilisateur.
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 en tant que message dans la boîte de dialogue. La longueur maximale de est d’environ prompt 1 024 caractères, selon la largeur des caractères utilisés. Si prompt a plusieurs lignes, vous pouvez séparer les lignes à l’aide d’un caractère de retour chariot (Chr(13)), d’un caractère de saut de ligne (Chr(10)) ou d’une combinaison retour chariot-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. En cas d’omission, la valeur par défaut de buttons 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 s’affiche 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 affecté à 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 |
Afficher OK uniquement. |
vbOKCancel |
1 |
Afficher OK et Annuler. |
vbAbortRetryIgnore |
2 |
Afficher Abandonner, Réessayer et Ignorer. |
vbYesNoCancel |
3 |
Affichez Oui, Non et Annuler. |
vbYesNo |
4 |
Afficher Oui et Non. |
vbRetryCancel |
5 |
Afficher Réessayer et Annuler. |
vbCritical |
16 |
Affichez l’icône Message critique . |
vbQuestion |
32 |
Affichez l’icône Requête d’avertissement . |
vbExclamation |
48 |
Affichez l’icône Message d’avertissement . |
vbInformation |
64 |
Affichez l’icône Message d’informations . |
vbDefaultButton1 |
0 |
Définissez le premier bouton par défaut. |
vbDefaultButton2 |
256 |
Définissez le deuxième bouton par défaut. |
vbDefaultButton3 |
512 |
Définissez le troisième bouton par défaut. |
vbDefaultButton4 |
768 |
Définissez le quatrième 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 actuelle. |
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 Aide à la boîte de message. |
VbMsgBoxSetForeground |
65536 |
Spécifiez la fenêtre de 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ébreux et arabes. |
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, 32, 48, 64) décrit le style d’icône. Le troisième groupe (0, , 512256) détermine le bouton par défaut. Le quatrième groupe (0, 4096) détermine la modalité de la boîte de message. Lorsque vous ajoutez des nombres pour créer une valeur finale pour l’argument buttons , utilisez un seul nombre de chaque groupe.
Remarque
Ces constantes sont spécifiées par Visual Basic pour Applications. Par conséquent, vous pouvez utiliser les noms n’importe où dans votre code au lieu des valeurs réelles.
Valeurs de retour
| Constante | Valeur | Description |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Annuler |
vbAbort |
3 |
Annuler |
vbRetry |
4 |
Réessayer |
vbIgnore |
5 |
Ignorer |
vbYes |
6 |
Oui |
vbNo |
7 |
Non |
Remarques
helpfile Lorsque et context sont fournis, l’utilisateur peut appuyer sur F1 dans Windows ou sur Aide dans macOS pour afficher la rubrique d’aide correspondant contextà . Certaines applications hôtes, telles que Microsoft Excel, ajoutent également automatiquement un bouton 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 de sélectionner Annuler. Si la boîte de dialogue contient un bouton Aide , l’aide contextuelle est fournie pour la boîte de dialogue. Toutefois, aucune valeur n’est retournée tant que l’utilisateur n’a pas sélectionné l’un des autres boutons.
Remarque
Pour spécifier plus que le premier argument nommé, vous devez utiliser MsgBox dans une expression. Pour omettre certains arguments positionnels, vous devez inclure le délimiteur de virgule correspondant.
Exemple
Remarque
L’exemple suivant montre comment utiliser cette fonction dans un module Visual Basic pour Applications (VBA).
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 retournée par la MsgBox fonction dépend du bouton sélectionné par l’utilisateur. Cet exemple suppose que DEMO.HLP est 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