Le Runtime Access 2007 français est disponible
| |
Affiche un message dans une boîte de dialogue, attend que l'utilisateur clique
sur un bouton et retourne une valeur de type Integer indiquant le bouton choisi
par l'utilisateur.
Syntaxe
MsgBox(prompt[, buttons] [, title] [, helpfile,
context])
La syntaxe de la fonction MsgBox comprend les arguments
nommés suivants :
Arguments de la fonction MsgBox
| Élément |
Description |
| prompt |
Obligatoire. Expression de type 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 prompt occupe plus d'une
ligne, n'oubliez pas d'insérer un vbCrLf entre chaque ligne. |
| buttons |
Facultatif. Expression numérique qui est
la somme des 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é du message. Pour les valeurs, reportez-vous à la section
ci-après. Si elle est omise, la valeur par défaut de l'argument
buttons 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 numérique
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. |
L'argument buttons peut avoir ces
paramètres :
Valeurs de l'argument Buttons
| Constante |
Valeur |
Description |
| vbOKOnly |
0 |
Affiche uniquement le bouton OK. |
| vbOKCancel |
1 |
Affiche les boutons OK et Annuler. |
| vbAbortRetryIgnore |
2 |
Affiche les boutons Abandon, 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 Demande 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. |
| vbSystemModal |
4096 |
Système modal ; toutes les applications sont
suspendues jusqu'à ce que l'utilisateur réponde au message. |
| vbMsgBoxHelpButton |
16384 |
Ajoute le bouton Aide au message. |
| VbMsgBoxSetForeground |
65536 |
Spécifie la fenêtre de message comme fenêtre de
premier plan. |
| vbMsgBoxRight |
524288 |
Aligne le texte à droite. |
| vbMsgBoxRtlReading |
1048576 |
Spécifie que le texte s'affiche de droite à gauche
sur les systèmes hébreux ou 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, 256,
512, 768) détermine le bouton par défaut ; et le quatrième groupe (0, 4096)
détermine la modalité du message. Au moment de l'ajout de nombres en vue de
créer une valeur finale pour l'argument buttons, n'utilisez qu'un seul
nombre de chaque groupe.
Des constantes sont définies par Visual Basic pour
Applications et peuvent remplacer des valeurs réelles partout dans votre code.
Valeurs renvoyées
Valeurs renvoyées
| Constante |
Valeur |
Description |
| vbOK |
1 |
OK |
| vbCancel |
2 |
Annuler |
| vbAbort |
3 |
Abandon |
| vbRetry |
4 |
Réessayer |
| vbIgnore |
5 |
Ignorer |
| vbYes |
6 |
Oui |
| vbNo |
7 |
Non |
Lorsque les deux arguments helpfile et context sont fournis,
l'utilisateur peut appuyer sur F1 (Windows) pour afficher la rubrique d'aide
correspondant à l'argument context.
Si la boîte de dialogue affiche un bouton Annuler, le fait d'appuyer sur la
touche ÉCHAP a le même effet que de cliquer sur Annuler. Si la boîte de dialogue
contient un bouton Aide, l'aide contextuelle est disponible pour la boîte de
dialogue. Toutefois, aucune valeur n'est retournée avant qu'un des autres
boutons ne soit sélectionné.Si vous souhaitez préciser
plus d'informations que celles fournies par le premier argument nommé, vous
devez utiliser la fonction MsgBox dans une expression. Si vous voulez omettre
certains arguments de position, vous devez placer la virgule de séparation
correspondante. | |
|