Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Développer Réduire

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

Mise à jour : novembre 2007

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é, du HelpNavigator et de la rubrique d'aide.

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,
	HelpNavigator navigator,
	Object param
)
public static DialogResult Show(
	String text,
	String caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	String helpFilePath,
	HelpNavigator navigator,
	Object param
)
public static function Show(
	text : String, 
	caption : String, 
	buttons : MessageBoxButtons, 
	icon : MessageBoxIcon, 
	defaultButton : MessageBoxDefaultButton, 
	options : MessageBoxOptions, 
	helpFilePath : String, 
	navigator : HelpNavigator, 
	param : Object
) : DialogResult

Paramètres

text
Type : System.String

Texte à afficher dans le message.

caption
Type : System.String

Texte à afficher dans la barre de titre du message.

buttons
Type : System.Windows.Forms.MessageBoxButtons

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

icon
Type : System.Windows.Forms.MessageBoxIcon

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

defaultButton
Type : System.Windows.Forms.MessageBoxDefaultButton

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

options
Type : System.Windows.Forms.MessageBoxOptions

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
Type : System.String

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

navigator
Type : System.Windows.Forms.HelpNavigator

Une des valeurs de HelpNavigator.

param
Type : System.Object

ID numérique de la rubrique d'aide à afficher lorsque l'utilisateur clique sur le bouton Aide.

Valeur de retour

Type : System.Windows.Forms.DialogResult

Une des valeurs de DialogResult.

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 et le sommaire de l'aide identifié par le paramètre navigator s'affiche. Le formulaire propriétaire du message (ou du formulaire actif) reçoit aussi l'événement HelpRequested.

Les fichiers d'aide compilés contiennent un sommaire, un index, une fonction de recherche ainsi que des liens sous forme de mots clés sur les pages. Vous pouvez utiliser les valeurs suivantes pour navigator : TableOfContents, Find, Index ou Topic.

Vous pouvez utiliser param pour affiner la commande Topic. Si la valeur spécifiée dans le paramètre navigator est TableOfContents, Index ou Find, cette valeur doit être null. Si le paramètre navigator fait référence à Topic, cette valeur doit également faire référence à un objet qui contient la valeur numérique de la rubrique à afficher.

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 et l'onglet d'index de l'aide et la rubrique identifiée par le mot clé ovals s'affichent. 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. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");



package WindowsApplication1;

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


...


// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show("Message with Help file and Help "
    + "navigator with additional parameter.", "Help Caption",
    MessageBoxButtons.OK, MessageBoxIcon.Question,
    MessageBoxDefaultButton.Button1, (MessageBoxOptions)0,
    "mspaint.chm", HelpNavigator.KeywordIndex, "ovals");


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft