MessageBox.Show Méthode

Définition

Affiche une boîte de message.

Surcharges

Show(String)

Affiche une boîte de message avec le texte spécifié.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié et le mot clé d'aide.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide, le HelpNavigator et la rubrique d'aide spécifiés.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide et le HelpNavigator spécifiés.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié et le mot clé d'aide.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide et le HelpNavigator spécifiés.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende, les boutons, l'icône et le bouton par défaut spécifiés.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende, les boutons et l'icône spécifiés.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône et le bouton par défaut spécifiés.

Show(IWin32Window, String, String, MessageBoxButtons)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende et les boutons spécifiés.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Affiche une boîte de message avec le texte, la légende, les boutons et l'icône spécifiés.

Show(IWin32Window, String, String)

Affiche une boîte de message devant l'objet spécifié, et avec le texte et la légende spécifiés.

Show(String, String, MessageBoxButtons)

Affiche une boîte de message avec le texte, la légende et le texte spécifiés.

Show(IWin32Window, String)

Affiche une boîte de message devant l'objet spécifié et avec le texte spécifié.

Show(String, String)

Affiche une boîte de message avec le texte et la légende spécifiés.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide, le HelpNavigator et la rubrique d'aide spécifiés.

Show(String)

Affiche une boîte de message avec le texte spécifié.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show (string text);
public static System.Windows.Forms.DialogResult Show (string? text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exemples

L’exemple de code suivant affiche une boîte de message simple.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}
Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Remarques

Par défaut, la boîte de message affiche un bouton OK . La boîte de message ne contient pas de légende dans le titre.

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié et le mot clé d'aide.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

keyword
String

Mot clé d'aide à afficher quand l'utilisateur clique sur le bouton Aide.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une boîte de message parentée à la fenêtre main. La boîte de message affiche un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le Mspaint.chm fichier d’aide est ouvert et la rubrique identifiée par le mspaint.chm::/paint_brush.htm mot clé s’affiche. L’exemple nécessite que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clavier ou clic de souris) ne peut se produire que pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant que l’entrée dans un autre formulaire puisse se produire. Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de propriétaire de niveau supérieur de la boîte de dialogue.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert et la rubrique d’aide mot clé identifiée par le keyword paramètre s’affiche. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide, le HelpNavigator et la rubrique d'aide spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

navigator
HelpNavigator

Une des valeurs de l'objet HelpNavigator.

param
Object

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

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une boîte de message avec un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le Mspaint.chm fichier d’aide est ouvert et l’onglet Index d’aide et la rubrique identifiée par le ovals mot clé s’affichent. L’exemple nécessite que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports 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.
System::Windows::Forms::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" );
// 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");
' 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.
Dim r5 As DialogResult = 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")

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert et le contenu d’aide identifié par le navigator paramètre s’affiche. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

Les fichiers d’aide compilés fournissent des liens de table des matières, d’index, de recherche et de mot clé dans des pages. Vous pouvez utiliser les valeurs suivantes pour navigator: TableOfContents, Find, Indexou Topic.

Vous pouvez utiliser param pour fournir un affinement supplémentaire de la Topic commande. Si la valeur spécifiée dans le navigator paramètre est TableOfContents, Indexou Find, cette valeur doit être null. Si le navigator paramètre fait référence Topicà , cette valeur doit référencer un objet qui contient la valeur numérique de la rubrique à afficher.

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

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une boîte de message parentée au formulaire main. La boîte de message affiche un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide Mspaint.chm s’ouvre. L’exemple exige que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise. Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

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

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide et le HelpNavigator spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

navigator
HelpNavigator

Une des valeurs de l'objet HelpNavigator.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une zone de message avec un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le Mspaint.chm fichier d’aide s’ouvre et l’onglet Index d’aide s’affiche. L’exemple exige que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert et le contenu d’aide identifié par le navigator paramètre s’affiche. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

Les fichiers d’aide compilés fournissent des liens de table des matières, d’index, de recherche et de mot clé dans des pages. Vous pouvez utiliser les valeurs suivantes pour navigator: TableOfContents, Find, Indexou Topic.

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

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié et le mot clé d'aide.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

keyword
String

Mot clé d'aide à afficher quand l'utilisateur clique sur le bouton Aide.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une zone de message avec un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le Mspaint.chm fichier d’aide s’ouvre et la rubrique identifiée par le mspaint.chm::/paint_brush.htm mot clé s’affiche. L’exemple exige que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert et la rubrique d’aide mot clé identifiée par le keyword paramètre s’affiche. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

buttons n’est pas membre de MessageBoxButtons

- ou -

icon n’est pas membre de MessageBoxIcon

- ou -

defaultButton n’est pas membre de MessageBoxDefaultButton

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é UserInteractive.

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

- ou -

options a spécifié DefaultDesktopOnly ou ServiceNotification et a indiqué une valeur dans le paramètre owner. Ces deux options ne doivent être utilisées que pour appeler la version de cette méthode qui ne prend pas un paramètre owner.

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche un MessageBox, offrant à l’utilisateur la possibilité d’annuler l’opération. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarques

Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue. Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une zone de message avec un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide Mspaint.chm s’ouvre. L’exemple exige que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// 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");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

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

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

displayHelpButton
Boolean

true pour afficher le bouton Aide ; sinon, false. La valeur par défaut est false.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une boîte de message avec un bouton Aide, gérer l’événement Control.HelpRequested et afficher une fenêtre d’aide personnalisée en réponse à l’événement.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Lorsque l’utilisateur clique sur le bouton Aide, le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit l’événement HelpRequested . Gérez l’événement HelpRequested pour effectuer des actions d’aide personnalisées.

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide et le HelpNavigator spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

navigator
HelpNavigator

Une des valeurs de l'objet HelpNavigator.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une boîte de message parentée à la fenêtre main. La boîte de message affiche un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le Mspaint.chm fichier d’aide s’ouvre et l’onglet Index d’aide s’affiche. L’exemple exige que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise. Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert et le contenu d’aide identifié par le navigator paramètre s’affiche. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

Les fichiers d’aide compilés fournissent des liens de table des matières, d’index, de recherche et de mot clé dans des pages. Vous pouvez utiliser les valeurs suivantes pour navigator: TableOfContents, Find, Indexou Topic.

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

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende, les boutons, l'icône et le bouton par défaut spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

buttons n’est pas membre de MessageBoxButtons

- ou -

icon n’est pas membre de MessageBoxIcon

- ou -

defaultButton n’est pas membre de MessageBoxDefaultButton

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é UserInteractive.

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche un MessageBox, offrant à l’utilisateur la possibilité d’annuler l’opération. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarques

Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue. Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende, les boutons et l'icône spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

buttons n’est pas membre de MessageBoxButtons

- ou -

icon n’est pas membre de MessageBoxIcon

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é UserInteractive.

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche un MessageBox, offrant à l’utilisateur la possibilité d’annuler l’opération. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarques

Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue. Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône et le bouton par défaut spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

buttons n’est pas membre de MessageBoxButtons

- ou -

icon n’est pas membre de MessageBoxIcon

- ou -

defaultButton n’est pas membre de MessageBoxDefaultButton

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é UserInteractive.

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche une MessageBox icône avec une zone de question, offrant à l’utilisateur la possibilité d’annuler l’opération. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Remarques

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons)

Affiche une boîte de message devant l'objet spécifié, et avec le texte, la légende et les boutons spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

buttons n’est pas membre de MessageBoxButtons

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é UserInteractive.

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche un MessageBox, offrant à l’utilisateur la possibilité d’annuler l’opération. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarques

Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue. Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Affiche une boîte de message avec le texte, la légende, les boutons et l'icône spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

Le paramètre buttons spécifié n'est pas un membre de MessageBoxButtons.

- ou -

Le paramètre icon spécifié n'est pas un membre de MessageBoxIcon.

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é UserInteractive.

Exemples

L’exemple de code suivant illustre l’une des méthodes lors de la Show gestion de l’événement ComboBox.DropDown . Pour exécuter l’exemple, collez le code suivant dans un formulaire et appelez la InitializeComboBox méthode à partir du constructeur ou Load de la méthode du formulaire.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Remarques

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(IWin32Window, String, String)

Affiche une boîte de message devant l'objet spécifié, et avec le texte et la légende spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Remarques

Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue. Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Par défaut, la zone de message affiche un bouton OK .

S’applique à

Show(String, String, MessageBoxButtons)

Affiche une boîte de message avec le texte, la légende et le texte spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

Le paramètre buttons spécifié n'est pas un membre de MessageBoxButtons.

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é UserInteractive.

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche un MessageBox, offrant à l’utilisateur la possibilité d’annuler l’opération. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}
Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Remarques

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(IWin32Window, String)

Affiche une boîte de message devant l'objet spécifié et avec le texte spécifié.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Remarques

Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue. Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise.

Par défaut, la zone de message affiche un bouton OK . La zone de message ne contient pas de légende dans le titre.

S’applique à

Show(String, String)

Affiche une boîte de message avec le texte et la légende spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (string text, string caption);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

Retours

Une des valeurs de l'objet DialogResult.

Remarques

Par défaut, la zone de message affiche un bouton OK .

S’applique à

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Paramètres

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher un MessageBox avec les options prises en charge par cette surcharge de Show. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche une MessageBox icône avec une zone de question, offrant à l’utilisateur la possibilité d’annuler l’opération. L’exemple utilise le RightAlign membre de l’énumération MessageBoxOptions pour aligner le texte sur le bord droit de la boîte de dialogue. Si la valeur de retour de la Show méthode est évaluée à Yes, le formulaire qui a affiché est MessageBox fermé.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarques

Vous pouvez avoir un maximum de trois boutons sur la zone de message.

Voir aussi

S’applique à

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide, le HelpNavigator et la rubrique d'aide spécifiés.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Paramètres

owner
IWin32Window

Implémentation de IWin32Window qui sera propriétaire de la boîte de dialogue modale.

text
String

Texte à afficher dans la boîte de message.

caption
String

Texte à afficher dans la barre de titre de la boîte de message.

buttons
MessageBoxButtons

Une des valeurs de MessageBoxButtons spécifiant les boutons à afficher dans la boîte de message.

icon
MessageBoxIcon

Une des valeurs de MessageBoxIcon spécifiant l'icône à afficher dans la boîte de message.

defaultButton
MessageBoxDefaultButton

Une des valeurs de MessageBoxDefaultButton spécifiant le bouton par défaut de la boîte de message.

options
MessageBoxOptions

Une des valeurs de MessageBoxOptions spécifiant les options d'affichage et d'association à utiliser dans la boîte de message. Vous pouvez passer la valeur 0 si vous voulez utiliser les valeurs par défaut.

helpFilePath
String

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

navigator
HelpNavigator

Une des valeurs de l'objet HelpNavigator.

param
Object

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

Retours

Une des valeurs de l'objet DialogResult.

Exceptions

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.

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é UserInteractive.

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

- ou -

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

Exemples

L’exemple de code suivant montre comment afficher une boîte de message parentée à la fenêtre main. La boîte de message affiche un bouton Aide. Lorsque l’utilisateur clique sur le bouton Aide, le Mspaint.chm fichier d’aide s’ouvre et l’onglet Index d’aide et la rubrique identifiée par le ovals mot clé s’affichent. L’exemple exige que le Mspaint.chm fichier d’aide soit installé.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "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" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Remarques

Une boîte de message est une boîte de dialogue modale, ce qui signifie qu’aucune entrée (clic au clavier ou à la souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant qu’une entrée dans un autre formulaire ne se produise. Vous pouvez utiliser le owner paramètre pour spécifier un objet particulier, qui implémente l’interface IWin32Window , qui servira de fenêtre de niveau supérieur et de propriétaire de la boîte de dialogue.

Lorsque l’utilisateur clique sur le bouton Aide, le fichier d’aide spécifié dans le helpFilePath paramètre est ouvert et le contenu d’aide identifié par le navigator paramètre s’affiche. Le formulaire qui possède la boîte de message (ou le formulaire actif) reçoit également l’événement HelpRequested .

Les fichiers d’aide compilés fournissent des liens de table des matières, d’index, de recherche et de mot clé dans des pages. Vous pouvez utiliser les valeurs suivantes pour navigator: TableOfContents, Find, Indexou Topic.

Vous pouvez utiliser param pour fournir un affinement supplémentaire de la Topic commande. Si la valeur spécifiée dans le navigator paramètre est TableOfContents, Indexou Find, cette valeur doit être null. Si le navigator paramètre fait référence Topicà , cette valeur doit référencer un objet qui contient la valeur numérique de la rubrique à afficher.

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

Voir aussi

S’applique à