MessageBox.Show 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

显示消息框。

重载

Show(String)	显示具有指定文本的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	使用指定的帮助文件和帮助关键字显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	使用指定的帮助文件、`HelpNavigator` 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	使用指定的帮助文件和 `HelpNavigator` 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	使用指定的帮助文件和帮助关键字显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	在指定对象的前面显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	使用指定的帮助文件和 `HelpNavigator` 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	在指定对象的前面显示具有指定文本、标题、按钮、图标和默认按钮的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	在指定对象的前面显示具有指定文本、标题、按钮和图标的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	显示具有指定文本、标题、按钮、图标和默认按钮的消息框。
Show(IWin32Window, String, String, MessageBoxButtons)	在指定对象的前面显示具有指定文本、标题和按钮的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon)	显示具有指定文本、标题、按钮和图标的消息框。
Show(IWin32Window, String, String)	在指定对象的前面显示具有指定文本和标题的消息框。
Show(String, String, MessageBoxButtons)	显示具有指定文本、标题和按钮的消息框。
Show(IWin32Window, String)	在指定对象的前面显示具有指定文本的消息框。
Show(String, String)	显示具有指定文本和标题的消息框。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	使用指定的帮助文件、`HelpNavigator` 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。

Show(String)

显示具有指定文本的消息框。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);

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

要在消息框中显示的文本。

DialogResult

DialogResult 值之一。

示例

下面的代码示例显示一个简单的消息框。

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

Private Sub DisplayMessageBoxText()

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

注解

默认情况下，消息框显示“ 确定” 按钮。消息框在标题中不包含描述文字。

适用于

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

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

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

keyword: String

在用户单击“帮助”按钮时显示的帮助关键字。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示main窗口的父级消息框。消息框显示“帮助”按钮。当用户单击“帮助”按钮时，Mspaint.chm将打开帮助文件，并显示由关键字 (keyword) 标识mspaint.chm::/paint_brush.htm的主题。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

消息框是模式对话框，这意味着除了模式窗体上的对象之外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常响应某些用户操作) ，然后才能输入另一个窗体。可以使用 owner 参数指定实现接口的特定对象，该对象 IWin32Window 将充当对话框的顶级所有者。

当用户单击“帮助”按钮时，将打开参数中指定的helpFilePath帮助文件，并显示参数keyword标识的帮助关键字 (keyword) 主题。拥有消息框 (的窗体或活动窗体) 也会接收事件 HelpRequested 。

另请参阅

适用于

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

使用指定的帮助文件、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, 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);

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

navigator: HelpNavigator

HelpNavigator 值之一。

param: Object

用户单击“帮助”按钮时显示的帮助主题的数值 ID。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示带有“帮助”按钮的消息框。当用户单击“帮助”按钮时，Mspaint.chm将打开“帮助”文件，并显示“帮助索引”选项卡和关键字 (keyword) 标识ovals的主题。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

消息框是模式对话框，这意味着除了模式窗体上的对象之外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常响应某些用户操作) ，然后才能输入另一个窗体。

当用户单击“帮助”按钮时，将打开参数中指定的 helpFilePath 帮助文件，并显示参数标识的 navigator 帮助内容。拥有消息框 (的窗体或活动窗体) 也会接收事件 HelpRequested 。

编译的帮助文件在页面中提供目录、索引、搜索和关键字 (keyword) 链接。可以将以下值用于 navigator： TableOfContents、 Find、 Index或 Topic。

可以使用 param 提供命令的 Topic 进一步优化。如果参数中指定的navigator值为、或 Find，Index则此值应为 null。TableOfContents navigator如果参数引用 Topic，则此值应引用一个对象，该对象包含要显示的主题的数值。

参数 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于

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

使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示main窗体的父级消息框。消息框显示“帮助”按钮。当用户单击“帮助”按钮时 Mspaint.chm ，将打开帮助文件。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

消息框是模式对话框，这意味着除了模式窗体上的对象之外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常响应某些用户操作) ，然后才能输入另一个窗体。可以使用 owner 参数指定实现接口的特定对象，该对象 IWin32Window 将充当对话框的顶级窗口和所有者。

当用户单击“帮助”按钮时，将打开参数中指定的 helpFilePath 帮助文件。拥有消息框 (的窗体或活动窗体) 也会接收事件 HelpRequested 。

参数 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于

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

使用指定的帮助文件和 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);

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

navigator: HelpNavigator

HelpNavigator 值之一。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示带有“帮助”按钮的消息框。当用户单击“帮助”按钮时， Mspaint.chm 将打开帮助文件并显示“帮助索引”选项卡。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

编译的帮助文件在页面中提供目录、索引、搜索和关键字 (keyword) 链接。可以将以下值用于 navigator： TableOfContents、 Find、 Index或 Topic。

参数 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于

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

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

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

keyword: String

在用户单击“帮助”按钮时显示的帮助关键字。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示带有“帮助”按钮的消息框。当用户单击“帮助”按钮时，Mspaint.chm将打开帮助文件，并显示由关键字 (keyword) 标识mspaint.chm::/paint_brush.htm的主题。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

消息框是模式对话框，这意味着除了模式窗体上的对象外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常为了响应某些用户操作) ，然后才能输入另一个窗体。

当用户单击“帮助”按钮时，将打开参数中指定的helpFilePath帮助文件，并显示参数标识keyword的帮助关键字 (keyword) 主题。拥有消息框 (的窗体或活动窗体) 也接收事件 HelpRequested 。

另请参阅

适用于

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

在指定对象的前面显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

或

defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

options 指定了 DefaultDesktopOnly 或 ServiceNotification 并在 owner 参数中指定一个值。仅当调用不接受 owner 参数的该方法版本时，才使用这两个选项。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示， MessageBox 其中包含此重载 Show支持的选项。验证字符串变量 ServerName为空后，该示例将显示， MessageBox为用户提供取消操作的选项。 Show如果方法的返回值计算结果为 Yes，则会关闭显示的MessageBox窗体。

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 将充当对话框的顶级窗口和所有者。消息框是模式对话框，这意味着除了模式窗体上的对象外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常为了响应某些用户操作) ，然后才能输入另一个窗体。

消息框中最多可以有三个按钮。

另请参阅

适用于

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

使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示带有“帮助”按钮的消息框。当用户单击“帮助”按钮时， Mspaint.chm 将打开帮助文件。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

当用户单击“帮助”按钮时，将打开参数中指定的 helpFilePath 帮助文件。拥有消息框 (的窗体或活动窗体) 也接收事件 HelpRequested 。

参数 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于

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

显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和“帮助”按钮的消息框。

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

displayHelpButton: Boolean

如果显示“帮助”按钮，则为 true；否则为 false。默认值为 false。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示带有“帮助”按钮的消息框、处理 Control.HelpRequested 事件以及显示自定义帮助窗口以响应事件。

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

注解

当用户单击“帮助”按钮时，拥有消息框的窗体 (或活动窗体) 接收事件 HelpRequested 。 HelpRequested处理事件以执行自定义帮助操作。

另请参阅

适用于

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

使用指定的帮助文件和 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);

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

navigator: HelpNavigator

HelpNavigator 值之一。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示父级main窗口的消息框。消息框显示“帮助”按钮。当用户单击“帮助”按钮时，将打开“帮助” Mspaint.chm 文件并显示“帮助索引”选项卡。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

消息框是模式对话框，这意味着除了模式窗体上的对象外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常为了响应某些用户操作) ，然后才能输入另一个窗体。可以使用 owner 参数指定实现接口的特定对象，该对象 IWin32Window 将充当对话框的顶级窗口和所有者。

当用户单击“帮助”按钮时，将打开参数中指定的 helpFilePath 帮助文件，并显示参数标识的 navigator 帮助内容。拥有消息框 (的窗体或活动窗体) 也接收事件 HelpRequested 。

编译的帮助文件在页面中提供目录、索引、搜索和关键字 (keyword) 链接。可以将以下值用于 navigator： TableOfContents、 Find、 Index或 Topic。

参数 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于

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

在指定对象的前面显示具有指定文本、标题、按钮、图标和默认按钮的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

或

defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

示例

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

注解

消息框中最多可以有三个按钮。

另请参阅

适用于

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

在指定对象的前面显示具有指定文本、标题、按钮和图标的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

示例

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

注解

消息框中最多可以有三个按钮。

另请参阅

适用于

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

显示具有指定文本、标题、按钮、图标和默认按钮的消息框。

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

或

defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

示例

下面的代码示例演示如何显示， MessageBox 其中包含此重载 Show支持的选项。验证字符串变量 ServerName为空后，该示例将显示一个 MessageBox 带有问题框图标的，为用户提供取消操作的选项。 Show如果方法的返回值计算结果为 Yes，则会关闭显示的MessageBox窗体。

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

注解

消息框中最多可以有三个按钮。

另请参阅

适用于

Show(IWin32Window, String, String, MessageBoxButtons)

在指定对象的前面显示具有指定文本、标题和按钮的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

示例

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

注解

消息框中最多可以有三个按钮。

另请参阅

MessageBoxButtons

适用于

Show(String, String, MessageBoxButtons, MessageBoxIcon)

显示具有指定文本、标题、按钮和图标的消息框。

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

指定的 buttons 参数不是 MessageBoxButtons 的成员。

- 或 -

指定的 icon 参数不是 MessageBoxIcon 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

示例

下面的代码示例演示处理 ComboBox.DropDown 事件时的方法之一Show。若要运行该示例，请将以下代码粘贴到窗体中，并从窗体的构造函数或Load方法调用 InitializeComboBox 方法。

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

注解

消息框中最多可以有三个按钮。

另请参阅

适用于

Show(IWin32Window, String, String)

在指定对象的前面显示具有指定文本和标题的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

DialogResult

DialogResult 值之一。

注解

可以使用 owner 参数指定实现接口的特定对象，该对象 IWin32Window 将充当对话框的顶级窗口和所有者。消息框是模式对话框，这意味着除了模式窗体上的对象之外，键盘或鼠标单击) 不会发生任何输入 (。程序必须隐藏或关闭模式窗体 (通常响应某些用户操作) ，然后才能输入另一个窗体。

默认情况下，消息框显示“ 确定” 按钮。

适用于

Show(String, String, MessageBoxButtons)

显示具有指定文本、标题和按钮的消息框。

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

指定的 buttons 参数不是 MessageBoxButtons 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

示例

下面的代码示例演示了如何使用此重载Show支持的选项显示 MessageBox 。在验证字符串变量 ServerName为空后，此示例将显示， MessageBox为用户提供取消操作的选项。 Show如果方法的返回值的计算结果为 Yes，则会关闭显示的MessageBox窗体。

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

注解

消息框中最多可以有三个按钮。

另请参阅

MessageBoxButtons

适用于

Show(IWin32Window, String)

在指定对象的前面显示具有指定文本的消息框。

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

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 的一个实现。

text: String

要在消息框中显示的文本。

DialogResult

DialogResult 值之一。

注解

默认情况下，消息框显示“ 确定” 按钮。消息框在标题中不包含描述文字。

适用于

Show(String, String)

显示具有指定文本和标题的消息框。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (string text, 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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

DialogResult

DialogResult 值之一。

注解

默认情况下，消息框显示“ 确定” 按钮。

适用于

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

显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。

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

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

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示了如何使用此重载Show支持的选项显示 MessageBox 。在验证字符串变量 ServerName为空后，此示例将显示一个 MessageBox 带有问题框图标的，为用户提供取消操作的选项。该示例使用 RightAlign 枚举的 MessageBoxOptions 成员将文本与对话框的右边缘对齐。 Show如果方法的返回值的计算结果为 Yes，则会关闭显示的MessageBox窗体。

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

注解

消息框中最多可以有三个按钮。

另请参阅

适用于

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

使用指定的帮助文件、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, 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);

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 的一个实现。

text: String

要在消息框中显示的文本。

caption: String

要在消息框的标题栏中显示的文本。

buttons: MessageBoxButtons

MessageBoxButtons 值之一，可指定在消息框中显示哪些按钮。

icon: MessageBoxIcon

MessageBoxIcon 值之一，它指定在消息框中显示哪个图标。

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton 值之一，可指定消息框中的默认按钮。

options: MessageBoxOptions

MessageBoxOptions 值之一，可指定将对消息框使用哪些显示和关联选项。若要使用默认值，请传入 0。

helpFilePath: String

用户单击“帮助”按钮时显示的“帮助”文件的路径和名称。

navigator: HelpNavigator

HelpNavigator 值之一。

param: Object

用户单击“帮助”按钮时显示的帮助主题的数值 ID。

DialogResult

DialogResult 值之一。

例外

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成员。

或

icon 不是 MessageBoxIcon 的成员。

- 或 -

指定的 defaultButton 不是 MessageBoxDefaultButton 的成员。

InvalidOperationException

尝试在运行模式不是用户交互模式的进程中显示 MessageBox。这是由 UserInteractive 属性指定的。

ArgumentException

options 同时指定了 DefaultDesktopOnly 和 ServiceNotification。

- 或 -

buttons 指定了无效的 MessageBoxButtons 组合。

示例

下面的代码示例演示如何显示main窗口的父级消息框。消息框显示“帮助”按钮。当用户单击“帮助”按钮时，Mspaint.chm将打开“帮助”文件，并显示“帮助索引”选项卡和关键字 (keyword) 标识ovals的主题。该示例要求 Mspaint.chm 安装帮助文件。

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

注解

编译的帮助文件在页面中提供目录、索引、搜索和关键字 (keyword) 链接。可以将以下值用于 navigator： TableOfContents、 Find、 Index或 Topic。

可以使用 param 来进一步优化 Topic 命令。如果参数中指定的navigator值为、 Index或 Find，则此值应为 null。TableOfContents navigator如果参数引用 Topic，则此值应引用一个对象，该对象包含要显示的主题的数值。

参数 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于