MsgBox, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Dans une base de données Access, la fonction MsgBox affiche un message dans une boîte de dialogue, attend que l’utilisateur clique sur un bouton et renvoie un nombre entier qui indique le bouton l’utilisateur a cliqué.

Syntaxe

MsgBox ( invite [boutons ] [titre ] [, fichier d’aide ] [contexte ] )

La syntaxe de la fonction MsgBox comporte les arguments suivants :

Argument

Description

invite de commandes

Obligatoire. Expression de chaîne affichée en tant que le message dans la boîte de dialogue. La longueur maximale de l’invite est d’environ 1 024 caractères, selon la largeur des caractères utilisés. Si l’invite de commandes est constituée de plusieurs lignes, vous pouvez séparer les lignes à l’aide d’un retour chariot (Chr13)()), un caractère de saut de ligne (Chr() 10)) ou retour chariot-combinaison de caractères de saut de ligne (Chr()13) & Chr() 10)) entre chaque ligne.

boutons

Facultatif. expression numérique 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, ainsi que la modalité de la boîte de message. En cas d’omission, la valeur par défaut pour les boutons est égal à 0.

titre

Facultatif. Expression de chaîne affichée dans la barre de titre de la boîte de dialogue. Si vous omettez le titre, le nom de l’application est placé dans la barre de titre.

fichier d’aide

Facultatif. Expression de chaîne qui identifie le fichier d’aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si l’argument est spécifié, contexte doivent également être fourni.

contexte

Facultatif. Expression numérique qui est le numéro de contexte affecté à la rubrique d’aide appropriée par l’auteur de l’aide. Si le contexte est fourni, fichier d’aide doit également.


Paramètres

Boutons argument sont les suivantes :

Constante

Valeur

Description

vbOKOnly

0

Affiche le bouton OK uniquement.

vbOKCancel

1

Affiche les boutons OK et Annuler .

vbAbortRetryIgnore

2

Afficher les boutons abandonner, Réessayeret Ignorer .

vbYesNoCancel

3

Afficher les boutons Oui, nonet Annuler .

vbYesNo

4

Afficher les boutons Oui et non .

vbRetryCancel

5

Afficher 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 de Message d’avertissement    .

vbInformation

64

Affiche l’icône Message d’informations .

vbDefaultButton1

0

Bouton première est la valeur par défaut.

vbDefaultButton2

256

Deuxième bouton est par défaut.

vbDefaultButton3

512

Bouton troisième est par défaut.

vbDefaultButton4

768

Bouton quatrième est par défaut.

vbApplicationModal

0

Application modale ; l’utilisateur doit répondre au message avant de continuer à travailler dans l’application en cours.

vbSystemModal

4096

Système modal ; toutes les applications sont suspendues jusqu'à ce que l’utilisateur répond à la zone de message.

vbMsgBoxHelpButton

16384

Ajoute le bouton aide à la boîte de message

VbMsgBoxSetForeground

65536

Spécifie la fenêtre de message en tant que la fenêtre de premier plan

vbMsgBoxRight

524288

Texte est aligné à droite

vbMsgBoxRtlReading

1048576

Spécifie le texte doit apparaître de droite à gauche sur les systèmes de l’hébreu et l’arabe


Conseil : Dans Access 2010, le Générateur d’Expression contient IntelliSense, afin que vous puissiez voir quels arguments votre expression requiert.

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) détermine le bouton par défaut ; et le quatrième groupe (0, 4096) détermine la modalité de la zone de message. Lorsque vous ajoutez des numéros afin de créer une valeur finale pour l’argument boutons , utilisez uniquement un numéro de chaque groupe.

Remarque : Ces constantes sont spécifiées par Visual Basic pour Applications. Par conséquent, les noms utilisable n’importe où dans votre code à la place des valeurs réelles.

Renvoyer des valeurs

Constante

Valeur

Description

vbOK

1

Bien

vbCancel

2

Annuler

vbAbort

3

Abandonner

vbRetry

4

Nouvelles tentatives

vbIgnore

5

Ignorer

vbYes

6

Oui

vbNo

7


Notes

Lorsque le fichier d’aide et contexte sont fournis, l’utilisateur peut appuyer sur F1 (Windows) ou aide (Macintosh) pour afficher la rubrique d’aide correspondant au contexte. Certaines applications hôtes, par exemple, Microsoft Excel, ajoutent également automatiquement un bouton aide à la boîte de dialogue.

Si la boîte de dialogue affiche un bouton Annuler , en appuyant sur la touche ÉCHAP a le même effet en cliquant sur Annuler. Si la boîte de dialogue contient un bouton aide , aide contextuelle est disponible pour la boîte de dialogue. Toutefois, aucune valeur n’est renvoyée jusqu'à ce qu’un des autres boutons est activé.

Remarque : Pour spécifier plus que le premier argument nommé, vous devez utiliser MsgBox dans un expression. Pour omettre certains arguments de position, vous devez inclure la virgule de séparation correspondante.

Exemple

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’Applications (VBA).

Cet exemple utilise la fonction MsgBox pour afficher un message d’erreur critique dans une boîte de dialogue avec boutons Oui et non. Le bouton non est spécifié en tant que réponse par défaut. La valeur renvoyée par la fonction MsgBox dépend du bouton choisi par l’utilisateur. Cet exemple suppose que DEMO.HLP est un fichier d’aide qui contient une rubrique dont le numéro d’aide contextuelle é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

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×