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

Un message est une boîte de dialogue modale, ce qui signifie que seules les entrées (à l'aide du clavier ou de la souris) affectant les objets du formulaire modal sont possibles. L'application doit masquer ou fermer le formulaire modal (généralement, après une action de l'utilisateur) avant qu'une entrée puisse être effectuée dans un autre formulaire. Vous pouvez utiliser le paramètre owner pour spécifier un objet particulier, qui implémente l'interface IWin32Window, qui fera office 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 paramètre helpFilePath s'ouvre et le sommaire de l'aide identifié par le paramètre navigator s'affiche. Le formulaire propriétaire du message (ou du formulaire actif) reçoit aussi l'événement HelpRequested.

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

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

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

L'exemple de code suivant illustre comment afficher un message apparenté à la fenêtre principale. Le message affiche un bouton Aide. Lorsque l'utilisateur clique sur le bouton Aide, le fichier d'aide Mspaint.chm s'ouvre et l'onglet d'index de l'aide et la rubrique identifiée par le mot clé ovals s'affichent. L'exemple nécessite l'installation du fichier d'aide Mspaint.chm.

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


...


// Display 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");

package WindowsApplication1;

import System.*;
import System.Drawing.*;
import System.ComponentModel.*;
import 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, (MessageBoxOptions)0,
    "mspaint.chm", HelpNavigator.KeywordIndex, "ovals");

• UIPermission 

  pour permettre aux sous-fenêtres sécurisées d'appeler cette méthode. Énumération associée : UIPermissionWindow.SafeSubWindows

• WebPermission 

  pour accéder à un fichier d'aide HTML par l'intermédiaire d'une demande HTTP. Énumération associée : NetworkAccess.Connect

• SecurityPermission 

  pour accéder à un fichier d'aide HTML non pris en charge à partir d'un serveur HTTP. Énumération associée : UnmanagedCode

• UIPermission 

  pour permettre aux sous-fenêtres sécurisées d'appeler cette méthode. Énumération associée : UIPermissionWindow.SafeSubWindows

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

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

.NET Framework

Référence