MessageBox.Show 方法

定义

显示消息框。

重载

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);
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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示主窗口父消息框。 消息框显示“帮助”按钮。 当用户单击“帮助”按钮时, Mspaint.chm 将打开帮助文件,并显示关键字标识 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 Help 关键字主题。 拥有消息框的窗体 (或活动窗体) 也会接收 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何使用“帮助”按钮显示消息框。 当用户单击“帮助”按钮时, Mspaint.chm 将打开“帮助”文件,并显示“帮助索引”选项卡和关键字标识 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 该事件。

编译的帮助文件提供页面中的目录、索引、搜索和关键字链接。 可以将以下值用于navigatorTableOfContents、、FindIndexTopic

可用于 param 进一步优化 Topic 命令。 如果参数中指定的navigator值为,IndexFind此值应为 nullTableOfContents 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示父级主窗体的消息框。 消息框显示“帮助”按钮。 当用户单击“帮助”按钮时,将 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何使用“帮助”按钮显示消息框。 当用户单击“帮助”按钮时, 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)

注解

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

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

编译的帮助文件提供页面中的目录、索引、搜索和关键字链接。 可以将以下值用于navigatorTableOfContents、、FindIndexTopic

参数 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何使用“帮助”按钮显示消息框。 当用户单击“帮助”按钮时, Mspaint.chm 将打开帮助文件,并显示关键字标识 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 Help 关键字主题。 拥有消息框的窗体 (或活动窗体) 也会接收 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何使用“帮助”按钮显示消息框。 当用户单击“帮助”按钮时,将 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示带有“帮助”按钮的消息框、处理 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示主窗口父级的消息框。 消息框显示“帮助”按钮。 当用户单击“帮助”按钮时, 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 该事件。

已编译的帮助文件在页面中提供目录、索引、搜索和关键字链接。 可以将以下值用于 navigatorTableOfContentsFindIndexTopic

参数 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

示例

下面的代码示例演示如何显示 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(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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

示例

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

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

注解

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

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

另请参阅

适用于

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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

尝试在运行模式不是用户交互模式的进程中显示 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

示例

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

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

注解

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

邮件框中最多可以有三个按钮。

另请参阅

适用于

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);
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 值之一。

例外

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

尝试在运行模式不是用户交互模式的进程中显示 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);
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);
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 值之一。

例外

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

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

示例

下面的代码示例演示如何显示 MessageBox 此重载 Show支持的选项。 验证字符串变量是否 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

注解

邮件框中最多可以有三个按钮。

另请参阅

适用于

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);
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 值之一。

注解

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

默认情况下,消息框将显示“ 确定 ”按钮。 消息框不包含标题。

适用于

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);
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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示 MessageBox 此重载 Show支持的选项。 验证字符串变量 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);
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 值之一。

例外

buttons 不是 MessageBoxButtons 的成员。

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

options 同时指定了 DefaultDesktopOnlyServiceNotification

示例

下面的代码示例演示如何显示主窗口父级的消息框。 消息框显示“帮助”按钮。 当用户单击“帮助”按钮时, Mspaint.chm 将打开帮助文件,并显示由关键字标识的 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")

注解

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

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

编译的帮助文件提供页面中的目录、索引、搜索和关键字链接。 可以将以下值用于 navigatorTableOfContentsFindIndexTopic

可用于 param 进一步优化 Topic 命令。 如果参数中指定的navigator值为,IndexFind此值应为 nullTableOfContents 如果参数 navigator 引用 Topic,此值应引用包含要显示的主题的数值的对象。

参数 helpFilePath 可以是 C:\path\sample.chm 或 /folder/file.htm。

另请参阅

适用于