MessageBox.Show MessageBox.Show MessageBox.Show MessageBox.Show Method

定义

显示消息框。Displays a message box.

重载

Show(String) Show(String) Show(String) Show(String)

显示具有指定文本的消息框。Displays a message box with specified text.

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

使用指定的帮助文件和帮助关键字显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。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.

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

使用指定的帮助文件、HelpNavigator 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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

使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

使用指定的帮助文件和 HelpNavigator 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

使用指定的帮助文件和帮助关键字显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。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.

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

在指定对象的前面显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

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

使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

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

使用指定的帮助文件和 HelpNavigator 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

在指定对象的前面显示具有指定文本、标题、按钮、图标和默认按钮的消息框。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

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

在指定对象的前面显示具有指定文本、标题、按钮和图标的消息框。Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

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

显示具有指定文本、标题、按钮、图标和默认按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, and default button.

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

在指定对象的前面显示具有指定文本、标题和按钮的消息框。Displays a message box in front of the specified object and with the specified text, caption, and buttons.

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

显示具有指定文本、标题、按钮和图标的消息框。Displays a message box with specified text, caption, buttons, and icon.

Show(IWin32Window, String, String) Show(IWin32Window, String, String) Show(IWin32Window, String, String) Show(IWin32Window, String, String)

在指定对象的前面显示具有指定文本和标题的消息框。Displays a message box in front of the specified object and with the specified text and caption.

Show(String, String, MessageBoxButtons) Show(String, String, MessageBoxButtons) Show(String, String, MessageBoxButtons) Show(String, String, MessageBoxButtons)

显示具有指定文本、标题和按钮的消息框。Displays a message box with specified text, caption, and buttons.

Show(IWin32Window, String) Show(IWin32Window, String) Show(IWin32Window, String) Show(IWin32Window, String)

在指定对象的前面显示具有指定文本的消息框。Displays a message box in front of the specified object and with the specified text.

Show(String, String) Show(String, String) Show(String, String) Show(String, String)

显示具有指定文本和标题的消息框。Displays a message box with specified text and caption.

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

显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, and options.

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

使用指定的帮助文件、HelpNavigator 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

Show(String) Show(String) Show(String) Show(String)

显示具有指定文本的消息框。Displays a message box with specified text.

public:
 static System::Windows::Forms::DialogResult Show(System::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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

返回

示例

下面的代码示例显示一个简单的消息框。The following code example displays a simple message box.

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

Private Sub DisplayMessageBoxText()

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

注解

默认情况下,该消息框显示确定按钮。By default, the message box displays an OK button. 消息框不包含标题中的标题。The message box does not contain a caption in the title.

安全性

UIPermission
用于将此属性设置安全子窗口。for safe subwindows to set this property. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

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

使用指定的帮助文件和帮助关键字显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。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.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

keyword
String String String String

在用户单击“帮助”按钮时显示的帮助关键字。The Help keyword to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示一个消息框,向主窗口的父级设置。The following code example demonstrates how to show a message box parented to the main window. 消息框显示帮助按钮。The message box displays a Help button. 当用户单击帮助按钮Mspaint.chm打开帮助文件,并由标识主题mspaint.chm::/paint_brush.htm显示关键字。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. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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")

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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. 可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级所有者。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.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数和帮助关键字主题标识的keyword显示参数。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. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

使用指定的帮助文件、HelpNavigator 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

param
Object Object Object Object

用户单击“帮助”按钮时显示的帮助主题的数值 ID。The numeric ID of the Help topic to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示具有帮助按钮的消息框。The following code example demonstrates how to show a message box with a Help button. 当用户单击帮助按钮Mspaint.chm打开文件的帮助和帮助索引选项卡,由标识主题ovals显示关键字。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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")

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数和帮助内容由navigator显示参数。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已编译的帮助文件提供的内容、 索引、 搜索和页面中的关键字链接表。Compiled help files provide table of contents, index, search, and keyword links in pages. 可以使用以下值: navigator: TableOfContentsFindIndex,或TopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

可以使用param以提供进一步的优化Topic命令。You can use param to provide further refinement of the Topic command. 如果在指定的值navigator参数是TableOfContentsIndex,或Find,此值应为nullIf the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. 如果navigator参数引用Topic,此值应引用一个对象,包含要显示的主题的数值。If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

helpFilePath参数可以是窗体 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示一个消息框,主窗体的父级。The following code example demonstrates how to show a message box that parented to the main form. 消息框显示帮助按钮。The message box displays a Help button. 当用户单击帮助按钮,Mspaint.chm打开帮助文件。When the user clicks the Help button, the Mspaint.chm Help file is opened. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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")

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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. 可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

helpFilePath参数可以是窗体 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

使用指定的帮助文件和 HelpNavigator 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示具有帮助按钮的消息框。The following code example demonstrates how to show a message box with a Help button. 当用户单击帮助按钮,Mspaint.chm帮助文件将打开并且显示帮助索引选项卡。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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)

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数和帮助内容由navigator显示参数。When the user clicks the Help button, the help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已编译的帮助文件提供的内容、 索引、 搜索和页面中的关键字链接表。Compiled Help files provide table of contents, index, search, and keyword links in pages. 可以使用以下值: navigator: TableOfContentsFindIndex,或TopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

helpFilePath参数可以是窗体 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

使用指定的帮助文件和帮助关键字显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。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.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

keyword
String String String String

在用户单击“帮助”按钮时显示的帮助关键字。The Help keyword to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示具有帮助按钮的消息框。The following code example demonstrates how to show a message box with a Help button. 当用户单击帮助按钮Mspaint.chm打开帮助文件,并由标识主题mspaint.chm::/paint_brush.htm显示关键字。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. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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")

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数和帮助关键字主题标识的keyword显示参数。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. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

在指定对象的前面显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框的默认按钮。One of the MessageBoxDefaultButton values the specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- defaultButton 不是 MessageBoxDefaultButton 的成员。defaultButton is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- options 指定了 DefaultDesktopOnlyServiceNotification 并在 owner 参数中指定一个值。options specified DefaultDesktopOnly or ServiceNotification and specified a value in the owner parameter. 仅当调用不接受 owner 参数的该方法版本时,才使用这两个选项。These two options should be used only if you invoke the version of this method that does not take an owner parameter.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox,为用户提供取消操作的选项。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner. 消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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 have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示具有帮助按钮的消息框。The following code example demonstrates how to show a message box with a Help button. 当用户单击帮助按钮,Mspaint.chm打开帮助文件。When the user clicks the Help button, the Mspaint.chm Help file is opened. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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")

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数。When the user clicks Help button, the Help file specified in the helpFilePath parameter is opened. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

helpFilePath参数可以是窗体 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

displayHelpButton
Boolean Boolean Boolean Boolean

如果显示“帮助”按钮,则为 true;否则为 falsetrue to show the Help button; otherwise, false. 默认值为 falseThe default is false.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示具有帮助按钮的消息框中,处理Control.HelpRequested事件,并显示自定义帮助窗口中对事件作出响应。The following code example demonstrates how to show a message box with a Help button, handle the Control.HelpRequested event, and show a custom help window in response to the event.

#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
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

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

当用户单击帮助按钮时,拥有该消息框 (或活动窗体) 的窗体将接收HelpRequested事件。When the user clicks the Help button, the form that owns the message box (or the active form) receives the HelpRequested event. 处理HelpRequested事件执行自定义帮助操作。Handle the HelpRequested event to perform custom Help actions.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

使用指定的帮助文件和 HelpNavigator 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示一个消息框,向主窗口的父级设置。The following code example demonstrates how to show a message box parented to the main window. 消息框显示帮助按钮。The message box displays a Help button. 当用户单击帮助按钮,Mspaint.chm帮助文件将打开并且显示帮助索引选项卡。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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)

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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. 可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数和帮助内容由navigator显示参数。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已编译的帮助文件提供的内容、 索引、 搜索和页面中的关键字链接表。Compiled Help files provide table of contents, index, search, and keyword links in pages. 可以使用以下值: navigator: TableOfContentsFindIndex,或TopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

helpFilePath参数可以是窗体 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

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

在指定对象的前面显示具有指定文本、标题、按钮、图标和默认按钮的消息框。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- defaultButton 不是 MessageBoxDefaultButton 的成员。defaultButton is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox,为用户提供取消操作的选项。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner. 消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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 have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

在指定对象的前面显示具有指定文本、标题、按钮和图标的消息框。Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox,为用户提供取消操作的选项。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner. 消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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 have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

显示具有指定文本、标题、按钮、图标和默认按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, and default button.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- defaultButton 不是 MessageBoxDefaultButton 的成员。defaultButton is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox带有问号框图标,为用户提供选项来取消该操作。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

您可以最多三个按钮的消息框上。You can have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

在指定对象的前面显示具有指定文本、标题和按钮的消息框。Displays a message box in front of the specified object and with the specified text, caption, and buttons.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

返回

异常

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox,为用户提供取消操作的选项。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner. 消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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 have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

显示具有指定文本、标题、按钮和图标的消息框。Displays a message box with specified text, caption, buttons, and icon.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

返回

异常

指定的 buttons 参数不是 MessageBoxButtons 的成员。The buttons parameter specified is not a member of MessageBoxButtons.

- 或 --or- 指定的 icon 参数不是 MessageBoxIcon 的成员。The icon parameter specified is not a member of MessageBoxIcon.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

示例

下面的代码示例演示了之一Show方法时处理ComboBox.DropDown事件。The following code example demonstrates one of the Show methods when handling the ComboBox.DropDown event. 若要运行该示例,请将以下代码粘贴在窗体并调用InitializeComboBox方法从窗体的构造函数或Load方法。To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

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

注解

您可以最多三个按钮的消息框上。You can have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

Show(IWin32Window, String, String) Show(IWin32Window, String, String) Show(IWin32Window, String, String) Show(IWin32Window, String, String)

在指定对象的前面显示具有指定文本和标题的消息框。Displays a message box in front of the specified object and with the specified text and caption.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

返回

注解

可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner. 消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

默认情况下,该消息框显示确定按钮。By default, the message box displays an OK button.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

Show(String, String, MessageBoxButtons) Show(String, String, MessageBoxButtons) Show(String, String, MessageBoxButtons) Show(String, String, MessageBoxButtons)

显示具有指定文本、标题和按钮的消息框。Displays a message box with specified text, caption, and buttons.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

返回

异常

指定的 buttons 参数不是 MessageBoxButtons 的成员。The buttons parameter specified is not a member of MessageBoxButtons.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox,为用户提供取消操作的选项。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

您可以最多三个按钮的消息框上。You can have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

Show(IWin32Window, String) Show(IWin32Window, String) Show(IWin32Window, String) Show(IWin32Window, String)

在指定对象的前面显示具有指定文本的消息框。Displays a message box in front of the specified object and with the specified text.

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);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

返回

注解

可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner. 消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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.

默认情况下,该消息框显示确定按钮。By default, the message box displays an OK button. 消息框不包含标题中的标题。The message box does not contain a caption in the title.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

Show(String, String) Show(String, String) Show(String, String) Show(String, String)

显示具有指定文本和标题的消息框。Displays a message box with specified text and caption.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

返回

注解

默认情况下,该消息框显示确定按钮。By default, the message box displays an OK button.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

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

显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, and options.

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);
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

参数

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示MessageBox使用此重载的支持的选项ShowThe following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 验证的后的字符串变量, ServerName,是空的该示例显示MessageBox带有问号框图标,为用户提供选项来取消该操作。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. 该示例使用RightAlign的成员MessageBoxOptions枚举,以将文本与对话框中的右边缘对齐。The example uses the RightAlign member of the MessageBoxOptions enumeration to align the text to the right edge of the dialog box. 如果Show方法的返回值的计算结果为Yes,显示的窗体MessageBox已关闭。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

注解

您可以最多三个按钮的消息框上。You can have a maximum of three buttons on the message box.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

另请参阅

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

使用指定的帮助文件、HelpNavigator 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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);
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

参数

owner
IWin32Window IWin32Window IWin32Window IWin32Window

将拥有模式对话框的 IWin32Window 的一个实现。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要在消息框中显示的文本。The text to display in the message box.

caption
String String String String

要在消息框的标题栏中显示的文本。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

MessageBoxButtons 值之一,可指定在消息框中显示哪些按钮。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

MessageBoxIcon 值之一,它指定在消息框中显示哪个图标。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

MessageBoxDefaultButton 值之一,可指定消息框中的默认按钮。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

MessageBoxOptions 值之一,可指定将对消息框使用哪些显示和关联选项。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 若要使用默认值,请传入 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。The path and name of the Help file to display when the user clicks the Help button.

param
Object Object Object Object

用户单击“帮助”按钮时显示的帮助主题的数值 ID。The numeric ID of the Help topic to display when the user clicks the Help button.

返回

异常

buttons 不是 MessageBoxButtons 的成员。buttons is not a member of MessageBoxButtons.

- 或 --or- icon 不是 MessageBoxIcon 的成员。icon is not a member of MessageBoxIcon.

- 或 --or- 指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。The defaultButton specified is not a member of MessageBoxDefaultButton.

尝试在运行模式不是用户交互模式的进程中显示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 这是由 UserInteractive 属性指定的。This is specified by the UserInteractive property.

options 同时指定了 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

- 或 --or- buttons 指定了无效的 MessageBoxButtons 组合。buttons specified an invalid combination of MessageBoxButtons.

示例

下面的代码示例演示如何显示一个消息框,向主窗口的父级设置。The following code example demonstrates how to show a message box parented to the main window. 消息框显示帮助按钮。The message box displays a Help button. 当用户单击帮助按钮Mspaint.chm打开文件的帮助和帮助索引选项卡,由标识主题ovals显示关键字。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. 该示例需要Mspaint.chm安装帮助文件。The example requires that the Mspaint.chm Help file is installed.

#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
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")

注解

消息框是模式对话框,这意味着没有输入 (键盘或鼠标单击) 模式的窗体上的对象不能进行除外。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. 可以使用owner参数来指定特定对象,用于实现IWin32Window接口,将作为对话框的顶级窗口和所有者。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 window and owner.

当用户单击帮助按钮时,帮助文件中指定helpFilePath打开参数和帮助内容由navigator显示参数。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 拥有消息框 (或活动窗体) 的窗体还接收HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已编译的帮助文件提供的内容、 索引、 搜索和页面中的关键字链接表。Compiled help files provide table of contents, index, search, and keyword links in pages. 可以使用以下值: navigator: TableOfContentsFindIndex,或TopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

可以使用param以提供进一步的优化Topic命令。You can use param to provide further refinement of the Topic command. 如果在指定的值navigator参数是TableOfContentsIndex,或Find,此值应为nullIf the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. 如果navigator参数引用Topic,此值应引用一个对象,包含要显示的主题的数值。If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

helpFilePath参数可以是窗体 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
用于安全子窗口调用此方法。for safe subwindows to call this method. 关联的枚举: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
若要通过 HTTP 请求访问的 HTML 帮助文件。to access a HTML help file through a HTTP request. 关联的枚举: ConnectAssociated enumeration: Connect

SecurityPermission
若要访问不从 HTTP 服务器提供的 HTML 帮助文件。to access a HTML help file not served from a HTTP server. 关联的枚举: UnmanagedCodeAssociated enumeration: UnmanagedCode

另请参阅

适用于