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 (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

 

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 avec le fichier d'aide, le HelpNavigator et la rubrique d'aide spécifiés.

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

public static DialogResult Show(
	IWin32Window owner,
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	string helpFilePath,
	HelpNavigator navigator,
	object param
)

Paramètres

owner
Type: System.Windows.Forms.IWin32Window

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

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.

helpFilePath
Type: System.String

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

navigator
Type: System.Windows.Forms.HelpNavigator

Une des valeurs de HelpNavigator.

param
Type: System.Object

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

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. Vous pouvez utiliser le owner pour spécifier un objet particulier, qui implémente le IWin32Window interface, qui servira de fenêtre de niveau supérieur et le 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 propriétaire de la boîte de message (ou le formulaire actif) reçoit aussi le HelpRequested événement.

Aide compilés fournissent des fichiers de table des matières, index, recherche et liens dans les pages. Vous pouvez utiliser les valeurs suivantes pour navigator: TableOfContents, Find, Index, ou Topic.

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

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

L’exemple de code suivant montre comment afficher un message apparenté à la fenêtre principale. La boîte de message affiche un bouton aide. Lorsque l’utilisateur clique sur le bouton aide, le Mspaint.chm aide fichier s’ouvre et l’onglet index d’aide et la rubrique identifiée par le ovals (mot clé) sont affichés. L’exemple requiert que le Mspaint.chm fichier d’aide est installé.

using System;
using System.Drawing;
using System.ComponentModel;
using 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.
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");

UIPermission

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

WebPermission

to access a HTML help file through a HTTP request. Associated enumeration: F:System.Net.NetworkAccess.Connect

SecurityPermission

to access a HTML help file not served from a HTTP server. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

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: