Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
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 DialogResultpublic static DialogResult Show(
IWin32Window owner,
string text,
string caption,
MessageBoxButtons buttons,
MessageBoxIcon icon,
MessageBoxDefaultButton defaultButton,
MessageBoxOptions options,
string helpFilePath,
string keyword
)public:
static DialogResult Show(
IWin32Window^ owner,
String^ text,
String^ caption,
MessageBoxButtons buttons,
MessageBoxIcon icon,
MessageBoxDefaultButton defaultButton,
MessageBoxOptions options,
String^ helpFilePath,
String^ keyword
)static member Show :
owner:IWin32Window *
text:string *
caption:string *
buttons:MessageBoxButtons *
icon:MessageBoxIcon *
defaultButton:MessageBoxDefaultButton *
options:MessageBoxOptions *
helpFilePath:string *
keyword:string -> DialogResult
Parameters
- owner
- Type: System.Windows.Forms
. . :: . IWin32Window
An implementation of IWin32Window that will own the modal dialog box.
- text
- Type: System
. . :: . String
The text to display in the message box.
- caption
- Type: System
. . :: . String
The text to display in the title bar of the message box.
- buttons
- Type: System.Windows.Forms
. . :: . MessageBoxButtons
One of the MessageBoxButtons values that specifies which buttons to display in the message box.
- icon
- Type: System.Windows.Forms
. . :: . MessageBoxIcon
One of the MessageBoxIcon values that specifies which icon to display in the message box.
- defaultButton
- Type: System.Windows.Forms
. . :: . MessageBoxDefaultButton
One of the MessageBoxDefaultButton values that specifies the default button for the message box.
- options
- Type: System.Windows.Forms
. . :: . MessageBoxOptions
One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. You may pass in 0 if you wish to use the defaults.
- helpFilePath
- Type: System
. . :: . String
The path and name of the Help file to display when the user clicks the Help button.
- keyword
- Type: System
. . :: . String
The Help keyword to display when the user clicks the Help button.
| Exception | Condition |
|---|---|
| InvalidEnumArgumentException | buttons is not a member of MessageBoxButtons. -or- icon is not a member of MessageBoxIcon. -or- The defaultButton specified is not a member of MessageBoxDefaultButton. |
| InvalidOperationException | An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. This is specified by the SystemInformation |
| ArgumentException | options specified both DefaultDesktopOnly and ServiceNotification. -or- buttons specified an invalid combination of MessageBoxButtons. |
A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level owner.
When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. The form that owns the message box (or the active form) also receives the HelpRequested event.
The following code example demonstrates how to show a message box parented to the main window. The message box displays a Help button. When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. The example requires that the Mspaint.chm Help file is installed.
Imports System
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.
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")
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,
// 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");
#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;
...
// 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" );
- UIPermission
for safe subwindows to call this method. Associated enumeration: UIPermissionWindow
. . :: . SafeSubWindows - WebPermission
to access a HTML help file through a HTTP request. Associated enumeration: NetworkAccess
. . :: . Connect - SecurityPermission
to access a HTML help file not served from a HTTP server. Associated enumeration: UnmanagedCode
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.