Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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

 

Date de publication : novembre 2016

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.

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

public static DialogResult Show(
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	bool displayHelpButton
)

Paramètres

text
Type: System.String

Texte à afficher dans la boîte de message.

caption
Type: System.String

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

buttons
Type: System.Windows.Forms.MessageBoxButtons

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

icon
Type: System.Windows.Forms.MessageBoxIcon

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

defaultButton
Type: System.Windows.Forms.MessageBoxDefaultButton

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

options
Type: System.Windows.Forms.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
Type: System.Boolean

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

Valeur de retour

Type: System.Windows.Forms.DialogResult

Une des valeurs de DialogResult.

Exception Condition
InvalidEnumArgumentException

buttons n’est pas un membre de MessageBoxButtons.

ou

icon n’est pas un membre de MessageBoxIcon.

ou

Le defaultButton spécifié n’est pas membre du MessageBoxDefaultButton.

InvalidOperationException

Une tentative a été effectuée pour afficher les MessageBox dans un processus qui n’est pas en cours d’exécution en mode utilisateur interactif. Cela est spécifié par le SystemInformation.UserInteractive propriété.

ArgumentException

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

ou

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

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

Lorsque l’utilisateur clique sur le bouton aide, le formulaire propriétaire de la boîte de message (ou le formulaire actif) reçoit le HelpRequested événement. Gérer les HelpRequested événements pour effectuer des actions d’aide personnalisées.

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
// 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;
}

UIPermission

for safe subwindows to call this method. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.SafeSubWindows

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: