Interaction.MsgBox, méthode

Affiche un message dans une boîte de dialogue, attend que l'utilisateur clique sur un bouton, puis retourne un nombre entier qui indique le bouton choisi par l'utilisateur.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function MsgBox ( _
    Prompt As Object, _
    <OptionalAttribute> Optional Buttons As MsgBoxStyle = MsgBoxStyle.OkOnly, _
    <OptionalAttribute> Optional Title As Object = Nothing _
) As MsgBoxResult
'Utilisation
Dim Prompt As Object
Dim Buttons As MsgBoxStyle
Dim Title As Object
Dim returnValue As MsgBoxResult

returnValue = Interaction.MsgBox(Prompt, Buttons, Title)

public static MsgBoxResult MsgBox (
    Object Prompt,
    [OptionalAttribute] MsgBoxStyle Buttons,
    [OptionalAttribute] Object Title
)

public:
static MsgBoxResult MsgBox (
    Object^ Prompt, 
    [OptionalAttribute] MsgBoxStyle Buttons, 
    [OptionalAttribute] Object^ Title
)

public static MsgBoxResult MsgBox (
    Object Prompt, 
    /** @attribute OptionalAttribute() */ MsgBoxStyle Buttons, 
    /** @attribute OptionalAttribute() */ Object Title
)

public static function MsgBox (
    Prompt : Object, 
    Buttons : MsgBoxStyle, 
    Title : Object
) : MsgBoxResult

Paramètres

• Prompt
  Obligatoire. Expression String affichée comme message de 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 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é du message. Si l'argument Buttons est omis, la valeur par défaut est zéro.

• Title
  Facultatif. Expression String 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.

Valeur de retour

Valeur constante OK, 1. Valeur constante Cancel, 2. Valeur constante Abort, 3. Valeur constante Retry, 4. Valeur constante Ignore, 5. Valeur constante Yes, 6. Valeur constante No, 7.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic MsgBox, fonction (Visual Basic).

Si la boîte de dialogue est dotée d'un bouton Annuler, appuyer sur Échap équivaut à cliquer sur Annuler. Si la boîte de dialogue contient un bouton d'aide (?), cela signifie qu'une aide contextuelle relative à la boîte de dialogue est disponible. Toutefois, aucune valeur n'est retournée tant que l'utilisateur n'a pas cliqué sur l'un des autres boutons.

Notes

Si vous souhaitez préciser plus d'informations que celles qui sont fournies par le premier argument, vous devez utiliser la fonction MsgBox dans une expression. Si vous omettez certains arguments de position, vous devez quand même conserver la virgule de séparation correspondante.

Notes

La fonction MsgBox nécessite UIPermission au niveau SafeTopLevelWindows, ce qui peut affecter son exécution dans les situations où le niveau de confiance n'est pas total. Pour plus d'informations, consultez Demande d'autorisations et UIPermission.

Les valeurs d'énumération MsgBoxStyle sont répertoriées dans le tableau suivant.

Membre	Valeur	Description
OKOnly	0	Affiche le bouton OK uniquement.
OKCancel	1	Affiche les boutons OK et Annuler.
AbortRetryIgnore	2	Affiche les boutons Abandonner, Réessayer et Ignorer.
YesNoCancel	3	Affiche les boutons Oui, Non et Annuler.
YesNo	4	Affiche les boutons Oui et Non.
RetryCancel	5	Affiche les boutons Réessayer et Annuler.
Critical	16	Affiche l'icône Message critique.
Question	32	Affiche l'icône Requête d'avertissement.
Exclamation	48	Affiche l'icône Message d'avertissement.
Information	64	Affiche l'icône Message d'information.
DefaultButton1	0	Le premier bouton est le bouton par défaut.
DefaultButton2	256	Le deuxième bouton est le bouton par défaut.
DefaultButton3	512	Le troisième bouton est le bouton par défaut.
ApplicationModal	0	L'application est modale. L'utilisateur doit répondre au message avant de poursuivre le travail dans l'application actuelle.
SystemModal	4096	Le système est modal. Toutes les applications sont interrompues jusqu'à ce que l'utilisateur réponde au message.
MsgBoxSetForeground	65536	Spécifie la fenêtre de message comme fenêtre de premier plan.
MsgBoxRight	524288	Le texte est aligné à droite.
MsgBoxRtlReading	1048576	Spécifie 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, 64) décrit le style d'icône. Le troisième groupe (0, 256, 512) définit le bouton par défaut. Le groupe quatrième (0, 4096) détermine la modalité du message et le cinquième groupe spécifie si la fenêtre de message est la fenêtre de premier de plan, ainsi que l'alignement et l'orientation du texte. 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.

Exemple

Cet exemple utilise la fonction MsgBox pour afficher un message d'erreur grave dans une boîte de dialogue pourvue des boutons Yes et No. Le bouton No est spécifié comme réponse par défaut. Ce résultat est obtenu en combinant les valeurs des constantes MsgBox dans une expression numérique. Dans ce cas, l'addition de 4 (la combinaison des boutons Yes/No) avec 16 (la fenêtre Message critique) et 256 (le deuxième bouton comme bouton par défaut) donne un total de 276. La valeur retournée par la fonction MsgBox dépend du bouton choisi par l'utilisateur : Yes retourne la valeur 6 ; No retourne la valeur 7.

Dim msg As String
Dim title As String
Dim style As MsgBoxStyle
Dim response As MsgBoxResult
msg = "Do you want to continue?"   ' Define message.
style = MsgBoxStyle.DefaultButton2 Or _
   MsgBoxStyle.Critical Or MsgBoxStyle.YesNo
title = "MsgBox Demonstration"   ' Define title.
' Display message.
response = MsgBox(msg, style, title)
If response = MsgBoxResult.Yes Then   ' User chose Yes.
   ' Perform some action.
Else
   ' Perform some other action.
End If

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms

Autres ressources

MsgBox, fonction (Visual Basic)
InputBox, fonction (Visual Basic)