Cette documentation est archivée et n’est pas conservée.

MessageBox.Show, méthode (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Affiche un message avec le texte, la légende, les boutons, l'icône, le bouton par défaut, les options et le bouton Aide à l'aide du fichier d'aide spécifié.

Espace de noms: System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public static DialogResult Show (
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	string helpFilePath
)
public static DialogResult Show (
	String text, 
	String caption, 
	MessageBoxButtons buttons, 
	MessageBoxIcon icon, 
	MessageBoxDefaultButton defaultButton, 
	MessageBoxOptions options, 
	String helpFilePath
)
public static function Show (
	text : String, 
	caption : String, 
	buttons : MessageBoxButtons, 
	icon : MessageBoxIcon, 
	defaultButton : MessageBoxDefaultButton, 
	options : MessageBoxOptions, 
	helpFilePath : String
) : DialogResult
Non applicable.

Paramètres

text

Texte à afficher dans le message.

caption

Texte à afficher dans la barre de titre du message.

buttons

Une des valeurs MessageBoxButtons spécifiant les boutons à afficher dans le message.

icon

Une des valeurs MessageBoxIcon spécifiant l'icône à afficher dans le message.

defaultButton

Une des valeurs MessageBoxDefaultButton spécifiant le bouton par défaut du message.

options

Une des valeurs MessageBoxOptions spécifiant les options d'affichage et d'association utilisées dans le message. Vous pouvez passer la valeur 0 si vous souhaitez utiliser les valeurs par défaut.

helpFilePath

Chemin d'accès et nom du fichier d'aide à afficher lorsque l'utilisateur clique sur le bouton Aide.

Valeur de retour

Une des valeurs de DialogResult.

Type d'exceptionCondition

InvalidEnumArgumentException

buttons n'est pas membre de MessageBoxButtons.

- ou -

icon n'est pas membre de MessageBoxIcon.

- ou -

Le defaultButton spécifié n'est pas un membre de MessageBoxDefaultButton.

InvalidOperationException

Une tentative d'affichage du MessageBox a eu lieu dans un processus qui n'est pas exécuté en mode utilisateur interactif. Cela est spécifié par la propriété SystemInformation.UserInteractive.

ArgumentException

options a spécifié à la fois DefaultDesktopOnly et ServiceNotification.

- ou -

buttons a spécifié une combinaison non valide de MessageBoxButtons.

Un message est une boîte de dialogue modale, ce qui signifie que seules les entrées (à l'aide du clavier ou de la souris) affectant les objets du formulaire modal sont possibles. L'application doit masquer ou fermer le formulaire modal (généralement, après une action de l'utilisateur) avant qu'une entrée puisse être effectuée dans un autre formulaire.

Lorsque l'utilisateur clique sur le bouton Aide, le fichier d'aide spécifié dans le paramètre helpFilePath s'ouvre. Le formulaire propriétaire du message (ou du formulaire actif) reçoit aussi l'événement HelpRequested.

Le paramètre helpFilePath peut avoir la forme "C:\path\sample.chm" ou "/folder/file.htm".

L'exemple de code suivant illustre comment afficher un message avec un bouton Aide. Lorsque l'utilisateur clique sur le bouton Aide, le fichier d'aide Mspaint.chm s'ouvre. L'exemple nécessite l'installation du fichier d'aide Mspaint.chm.

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
...

            // Display a message box with a help button. 
            // The Help button opens the Mspaint.chm Help file.
            DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                               "Help Caption", MessageBoxButtons.OK, 
                                               MessageBoxIcon.Question, 
                                               MessageBoxDefaultButton.Button1, 
                                               0, 
                                               "mspaint.chm");

package WindowsApplication1;

import System.*;
import System.Drawing.*;
import System.ComponentModel.*;
import System.Windows.Forms.*;
...

        // Display a message box with a help button. 
        // The Help button opens the Mspaint.chm Help file.
        DialogResult r1 = MessageBox.Show("Message with Help file.",
            "Help Caption", MessageBoxButtons.OK, MessageBoxIcon.Question,
            MessageBoxDefaultButton.Button1,(MessageBoxOptions)0,"mspaint.chm");

Windows 98, Windows Server 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

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Afficher: