Affiche un message dans une boîte de dialogue, attend que l'utilisateur clique sur un bouton, puis renvoie une valeur de type Integer qui indique le bouton choisi par l'utilisateur.
Syntaxe
Public Function MsgBox(ByVal Prompt As String, _
Optional ByVal buttons As VbMsgBoxStyle = 0, _
Optional ByVal Title As String = "App.title", _
Optional ByVal HelpFile As String = "", _
Optional ByVal Context As Long = 0, _
Optional ByVal exOptions As exMsgBoxStyle = 0, _
Optional ByVal Details As String = "", _
Optional ByRef DefaultIfCheckedYet As VbMsgBoxResult = 0, _ <= MODIFICATION VERSION 4.5
Optional ByVal Icon As IPictureDisp = Nothing, _
Optional ByVal strSound As String = "Default") As VbMsgBoxResul
La syntaxe de la fonction MsgBox comprend les arguments nommés suivants :
| Élément | Description |
| prompt | Expression de chaîne affichée comme message dans la boîte de dialogue. La longueur maximale de l'argument prompt est d'environ 1 024 caractères selon la largeur des caractères utilisés. Si l'argument prompt occupe plus d'une ligne, n'oubliez pas d'insérer un retour chariot (Chr(13)) ou un saut de ligne (Chr(10)) entre les lignes, ou une combinaison de caractères retour chariot-saut de ligne (Chr(13) & Chr(10)). |
| buttons | Facultatif. Expression numérique qui représente la somme des valeurs indiquant le nombre et le type de boutons à afficher, le style d'icône à utiliser, l'identité du bouton par défaut, ainsi que la modalité du message. Si l'argument buttons est omis, sa valeur par défaut est 0. |
| title | Facultatif. Expression de chaîne affichée dans la barre de titre de la boîte de dialogue. Si l'argument title est omis, 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 sur la boîte de dialogue. Si l'argument helpfile est défini, l'argument context doit l'être également. |
| context | Facultatif. Expression indiquant le numéro de contexte attribué par l'auteur de l'aide à la rubrique appropriée. Si l'argument context est défini, l'argument helpfile doit l'être également. |
| exOptions | Facultatif. Expresion numérique qui représente
la somme des valeurs indiquant les options suppléméntaires
a affecter voir le type exMsgBoxStyle pour plus de détails |
| Details | Facultatif Expression de chaîne affichée dans la zone du bas, remarque le bouton "Détails=>" apparait automatiquement lorsque Details est different d'une chaine vide |
| DefaultIfCheckedYet | Facultatif Argument BYREF permet de mettre a jour
une variable pour ne plus poser cette question si la checkBox a été
cochée si DefaultIfCheckedYet est différent de 0 la MsgBox ne s'affiche pas et renvoie automatiquement cette valeur |
| Icon | Facultatif Spécifie un élément graphique, permet d'afficher une icone différente des 4 icones configurables intégrées |
| strSound | Facultatif Expression de chaîne qui spécifie un fichier contenant un élément sonore (fichier WAV), permet de jouer un son différent des 5 sons configurables intégrées |
Valeurs
L'argument exOptions prend les valeurs suivantes :
'===========================================================================
' Détails du type exMsgBoxStyle
'===========================================================================
Public Enum exMsgBoxStyle
exCenterScreen = 0 'centre la boite sur l'écran
exShowCheck = 2 'affiche la checkbox
exNoModal = 4 'affiche la boite en mode non modal
exWaitTime = 8 'bloque les boutons pendant DelaySec
exCenterOwner = 16 'centre la boite sur la form appelante
exManual = 32 'position la feuille sur FormLeft et FormTop
exMsgBoxCenter = 64 'centre le texte du message
exSendAuto = 128 'permet l'envoie en mode auto
exSendManual = 256 'envoie en mode manuel on utilise alors l'evenement SendClick
End Enum
L'argument buttons prend les valeurs suivantes :
| Constant | Value | Description |
| vbOKOnly | 0 | Affiche le bouton OK uniquement. |
| vbOKCancel | 1 | Affiche les boutons OK et Annuler. |
| vbAbortRetryIgnore | 2 | Affiche le bouton Abandonner, 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ône Message critique. |
| vbQuestion | 32 | Affiche l'icône Requête d'avertissement. |
| vbExclamation | 48 | Affiche l'icône Message d'avertissement. |
| vbInformation | 64 | Affiche l'icône Message 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 en cours. |
| 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. SEMBLE NE PAS FONCTIONNER DANS MsgBox inversion avec VbMsgBoxSetForeground ?! |
| vbMsgBoxHelpButton | 16384 | Ajoute le bouton Aide à la zone de message. |
| VbMsgBoxSetForeground | 65536 | Indique la fenêtre de zone de message comme fenêtre de premier
plan. SEMBLE NE PAS FONCTIONNER DANS MsgBox |
| vbMsgBoxRight | 524288 | Le teste est aligné à droite. |
| vbMsgBoxRtlReading | 1048576 |
Indique que le texte doit apparaître de droite à gauche sur les systèmes
hébraïques 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 et 64) décrit le style d'icône. Le troisième groupe (0, 256 et 512) définit le bouton par défaut. Enfin, le quatrième groupe (0 et 4 096) détermine la modalité de la zone de message. Au moment d'additionner ces nombres pour obtenir la valeur finale de l'argument buttons, ne sélectionnez qu'un seul nombre dans chaque groupe.
Valeurs renvoyées
| 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 |
et DefaultIfCheckedYet est modifié si la checkBox a été cochée