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

定義

顯示訊息方塊。Displays a message box.

多載

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

顯示含有指定文字的訊息方塊。Displays a message box with specified text.

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

使用指定的說明檔和說明關鍵字,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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

使用指定的說明檔、HelpNavigator 和說明主題,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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

使用指定的說明檔,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

使用指定的說明檔和 HelpNavigator,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

使用指定的說明檔和說明關鍵字,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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

在指定物件的前面顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

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

使用指定的說明檔,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

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

使用指定的說明檔和 HelpNavigator,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

在指定物件的前面顯示含有指定文字、標題、按鈕、圖示和預設按鈕的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

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

在指定物件的前面顯示含有指定文字、標題、按鈕和圖示的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

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

顯示含有指定文字、標題、圖示和預設按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, and default button.

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

在指定物件的前面顯示含有指定文字、標題和按鈕的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, and buttons.

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

顯示含有指定文字、標題、按鈕和圖示的訊息方塊。Displays a message box with specified text, caption, buttons, and icon.

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

在指定物件的前面顯示含有指定文字和標題的訊息方塊。Displays a message box in front of the specified object and with the specified text and caption.

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

顯示含有指定文字、標題和按鈕的訊息方塊。Displays a message box with specified text, caption, and buttons.

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

在指定物件的前面顯示含有指定文字的訊息方塊。Displays a message box in front of the specified object and with the specified text.

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

顯示含有指定文字和標題的訊息方塊。Displays a message box with specified text and caption.

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

顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, and options.

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

使用指定的說明檔、HelpNavigator 和說明主題,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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

顯示含有指定文字的訊息方塊。Displays a message box with specified text.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show (string text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

傳回

範例

下列程式碼範例會顯示簡單的訊息方塊。The following code example displays a simple message box.

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

Private Sub DisplayMessageBoxText()

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

備註

根據預設, 訊息方塊會顯示 [確定] 按鈕。By default, the message box displays an OK button. 訊息方塊不包含標題中的標題。The message box does not contain a caption in the title.

安全性

UIPermission
適用于安全子視窗設定此屬性。for safe subwindows to set this property. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

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

使用指定的說明檔和說明關鍵字,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

keyword
String String String String

當使用者按下 [說明] 按鈕時要顯示的說明關鍵字。The Help keyword to display when the user clicks the Help button.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何在主視窗中顯示一個父系的訊息方塊。The following code example demonstrates how to show a message box parented to the main window. 訊息方塊會顯示 [說明] 按鈕。The message box displays a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔, 並顯示mspaint.chm::/paint_brush.htm關鍵字所識別的主題。When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. 您可以使用owner參數來指定特定物件, 其IWin32Window會實作為對話方塊的頂層擁有者, 以執行介面。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level owner.

當使用者按一下 [說明] 按鈕時, 就會開啟helpFilePath參數中指定的說明檔, 並顯示keyword由參數所識別的說明關鍵字主題。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

使用指定的說明檔、HelpNavigator 和說明主題,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator HelpNavigator HelpNavigator HelpNavigator

其中一個 HelpNavigator 值。One of the HelpNavigator values.

param
Object Object Object Object

當使用者按下 [說明] 按鈕時要顯示之說明主題的數字 ID。The numeric ID of the Help topic to display when the user clicks the Help button.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何顯示含有 [說明] 按鈕的訊息方塊。The following code example demonstrates how to show a message box with a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔, 並顯示 [說明] 索引標籤和ovals關鍵字所識別的主題。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

當使用者按一下 [說明] 按鈕時, 會開啟helpFilePath參數中指定的說明檔, 並顯示navigator參數所識別的說明內容。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。Compiled help files provide table of contents, index, search, and keyword links in pages. 您可以使用下列值navigator: TableOfContentsFindIndexTopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

您可以使用param來提供進一步Topic的命令精簡。You can use param to provide further refinement of the Topic command. 如果navigator參數中指定的值為TableOfContentsIndexFind, 則這個值應該是nullIf the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. 如果參數參考Topic, 此值應參考包含要顯示之主題數值的物件。 navigatorIf the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

helpFilePath參數的格式可以是 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

使用指定的說明檔,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何顯示以主要表單為父代的訊息方塊。The following code example demonstrates how to show a message box that parented to the main form. 訊息方塊會顯示 [說明] 按鈕。The message box displays a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔。When the user clicks the Help button, the Mspaint.chm Help file is opened. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. 您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

當使用者按一下 [說明] 按鈕時, 就會開啟helpFilePath參數中指定的說明檔。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

helpFilePath參數的格式可以是 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

使用指定的說明檔和 HelpNavigator,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator HelpNavigator HelpNavigator HelpNavigator

其中一個 HelpNavigator 值。One of the HelpNavigator values.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何顯示含有 [說明] 按鈕的訊息方塊。The following code example demonstrates how to show a message box with a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔, 並顯示 [說明] 索引標籤。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

當使用者按一下 [說明] 按鈕時, 會開啟helpFilePath參數中指定的說明檔, 並顯示navigator參數所識別的說明內容。When the user clicks the Help button, the help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。Compiled Help files provide table of contents, index, search, and keyword links in pages. 您可以使用下列值navigator: TableOfContentsFindIndexTopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

helpFilePath參數的格式可以是 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

使用指定的說明檔和說明關鍵字,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

keyword
String String String String

當使用者按下 [說明] 按鈕時要顯示的說明關鍵字。The Help keyword to display when the user clicks the Help button.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何顯示含有 [說明] 按鈕的訊息方塊。The following code example demonstrates how to show a message box with a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔, 並顯示mspaint.chm::/paint_brush.htm關鍵字所識別的主題。When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

當使用者按一下 [說明] 按鈕時, 就會開啟helpFilePath參數中指定的說明檔, 並顯示keyword由參數所識別的說明關鍵字主題。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

在指定物件的前面顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values the specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

-或--or- options 指定 DefaultDesktopOnlyServiceNotification 並指定 owner 參數中的值。options specified DefaultDesktopOnly or ServiceNotification and specified a value in the owner parameter. 這兩個選項的使用時機為,當您叫用 (Invoke) 的方法版本無法接受 owner 參數時。These two options should be used only if you invoke the version of this method that does not take an owner parameter.

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

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示, 提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

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

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

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

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. 訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

使用指定的說明檔,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何顯示含有 [說明] 按鈕的訊息方塊。The following code example demonstrates how to show a message box with a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔。When the user clicks the Help button, the Mspaint.chm Help file is opened. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

當使用者按一下 [說明] 按鈕時, 就會開啟helpFilePath參數中指定的說明檔。When the user clicks Help button, the Help file specified in the helpFilePath parameter is opened. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

helpFilePath參數的格式可以是 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

displayHelpButton
Boolean Boolean Boolean Boolean

若要顯示 [說明] 按鈕,則為 true,否則為 falsetrue to show the Help button; otherwise, false. 預設為 falseThe default is false.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何顯示含有 [說明] 按鈕的訊息方塊、處理Control.HelpRequested事件, 以及顯示自訂說明視窗以回應事件。The following code example demonstrates how to show a message box with a Help button, handle the Control.HelpRequested event, and show a custom help window in response to the event.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

當使用者按一下 [說明] 按鈕時, 擁有訊息方塊 (或使用中表單) 的表單就HelpRequested會收到事件。When the user clicks the Help button, the form that owns the message box (or the active form) receives the HelpRequested event. HelpRequested處理事件以執行自訂說明動作。Handle the HelpRequested event to perform custom Help actions.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

使用指定的說明檔和 HelpNavigator,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator HelpNavigator HelpNavigator HelpNavigator

其中一個 HelpNavigator 值。One of the HelpNavigator values.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何在主視窗中顯示一個父系的訊息方塊。The following code example demonstrates how to show a message box parented to the main window. 訊息方塊會顯示 [說明] 按鈕。The message box displays a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔, 並顯示 [說明] 索引標籤。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. 您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

當使用者按一下 [說明] 按鈕時, 會開啟helpFilePath參數中指定的說明檔, 並顯示navigator參數所識別的說明內容。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。Compiled Help files provide table of contents, index, search, and keyword links in pages. 您可以使用下列值navigator: TableOfContentsFindIndexTopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

helpFilePath參數的格式可以是 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

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

在指定物件的前面顯示含有指定文字、標題、按鈕、圖示和預設按鈕的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示, 提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

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

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

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

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. 訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

在指定物件的前面顯示含有指定文字、標題、按鈕和圖示的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

傳回

例外狀況

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示, 提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

    // Checks the value of the text.

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

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

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

        // Displays the MessageBox.

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

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. 訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

顯示含有指定文字、標題、圖示和預設按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, and default button.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示具有問題方塊圖示的, 並提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

    // Checks the value of the text.

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

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

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

        // Displays the MessageBox.

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

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

備註

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

在指定物件的前面顯示含有指定文字、標題和按鈕的訊息方塊。Displays a message box in front of the specified object and with the specified text, caption, and buttons.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

傳回

例外狀況

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示, 提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

    // Checks the value of the text.

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

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

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

        // Displays the MessageBox.

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

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. 訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

顯示含有指定文字、標題、按鈕和圖示的訊息方塊。Displays a message box with specified text, caption, buttons, and icon.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

傳回

例外狀況

指定的 buttons 參數不是 MessageBoxButtons 的成員。The buttons parameter specified is not a member of MessageBoxButtons.

-或--or- 指定的 icon 參數不是 MessageBoxIcon 的成員。The icon parameter specified is not a member of MessageBoxIcon.

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

範例

下列程式碼範例示範Show ComboBox.DropDown處理事件時的其中一個方法。The following code example demonstrates one of the Show methods when handling the ComboBox.DropDown event. 若要執行範例, 請在表單中貼上下列程式碼InitializeComboBox , 並從表單的函Load式或方法呼叫方法。To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

備註

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

在指定物件的前面顯示含有指定文字和標題的訊息方塊。Displays a message box in front of the specified object and with the specified text and caption.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

傳回

備註

您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. 訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

根據預設, 訊息方塊會顯示 [確定] 按鈕。By default, the message box displays an OK button.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

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

顯示含有指定文字、標題和按鈕的訊息方塊。Displays a message box with specified text, caption, and buttons.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

傳回

例外狀況

指定的 buttons 參數不是 MessageBoxButtons 的成員。The buttons parameter specified is not a member of MessageBoxButtons.

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示, 提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}
Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

備註

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

在指定物件的前面顯示含有指定文字的訊息方塊。Displays a message box in front of the specified object and with the specified text.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

傳回

備註

您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. 訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

根據預設, 訊息方塊會顯示 [確定] 按鈕。By default, the message box displays an OK button. 訊息方塊不包含標題中的標題。The message box does not contain a caption in the title.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

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

顯示含有指定文字和標題的訊息方塊。Displays a message box with specified text and caption.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (string text, string caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

傳回

備註

根據預設, 訊息方塊會顯示 [確定] 按鈕。By default, the message box displays an OK button.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

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

顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, and options.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

參數

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何MessageBox使用的這個Show多載所支援的選項來顯示。The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. 確認字串變數ServerName是空的之後, 此範例會MessageBox顯示具有問題方塊圖示的, 並提供使用者取消作業的選項。After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. 此範例會使用RightAlign MessageBoxOptions列舉的成員, 將文字對齊對話方塊的右邊緣。The example uses the RightAlign member of the MessageBoxOptions enumeration to align the text to the right edge of the dialog box. 如果方法的傳回值評估為Yes, 則顯示的MessageBox表單就會關閉。 ShowIf the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

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

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

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

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

訊息方塊上最多可以有三個按鈕。You can have a maximum of three buttons on the message box.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

另請參閱

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

使用指定的說明檔、HelpNavigator 和說明主題,顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

參數

owner
IWin32Window IWin32Window IWin32Window IWin32Window

IWin32Window 實作,將擁有強制回應對話方塊。An implementation of IWin32Window that will own the modal dialog box.

text
String String String String

要顯示在訊息方塊中的文字。The text to display in the message box.

caption
String String String String

要顯示在訊息方塊標題列中的文字。The text to display in the title bar of the message box.

buttons
MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons

其中一個 MessageBoxButtons 值,指定要在訊息方塊中顯示哪些按鈕。One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

其中一個 MessageBoxIcon 值,指定那個圖示要顯示在訊息方塊中。One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值,指定訊息方塊的預設按鈕。One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

其中一個 MessageBoxOptions 值,指定訊息方塊使用的顯示及關聯的選項。One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. 如果要使用預設值,可以傳遞 0。You may pass in 0 if you wish to use the defaults.

helpFilePath
String String String String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator HelpNavigator HelpNavigator HelpNavigator

其中一個 HelpNavigator 值。One of the HelpNavigator values.

param
Object Object Object Object

當使用者按下 [說明] 按鈕時要顯示之說明主題的數字 ID。The numeric ID of the Help topic to display when the user clicks the Help button.

傳回

例外狀況

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

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

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

嘗試在不執行使用者互動模式的處理序中顯示 MessageBoxAn attempt was made to display the MessageBox in a process that is not running in User Interactive mode. 這個由 UserInteractive 屬性所指定。This is specified by the UserInteractive property.

options 指定 DefaultDesktopOnlyServiceNotificationoptions specified both DefaultDesktopOnly and ServiceNotification.

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

範例

下列程式碼範例示範如何在主視窗中顯示一個父系的訊息方塊。The following code example demonstrates how to show a message box parented to the main window. 訊息方塊會顯示 [說明] 按鈕。The message box displays a Help button. 當使用者按一下 [說明] 按鈕時, Mspaint.chm就會開啟說明檔, 並顯示 [說明] 索引標籤和ovals關鍵字所識別的主題。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. 此範例需要Mspaint.chm安裝說明檔。The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

備註

訊息方塊是強制回應對話方塊, 這表示不會出現任何輸入 (鍵盤或滑鼠按一下), 除了強制回應表單上的物件以外。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. 程式必須先隱藏或關閉強制回應表單 (通常是為了回應某些使用者動作), 然後才能進行其他表單的輸入。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. 您可以使用owner參數來指定執行IWin32Window介面的特定物件, 其會當做對話方塊的最上層視窗和擁有者。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

當使用者按一下 [說明] 按鈕時, 會開啟helpFilePath參數中指定的說明檔, 並顯示navigator參數所識別的說明內容。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. 擁有訊息方塊 (或使用中表單) 的表單也會收到HelpRequested事件。The form that owns the message box (or the active form) also receives the HelpRequested event.

已編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。Compiled help files provide table of contents, index, search, and keyword links in pages. 您可以使用下列值navigator: TableOfContentsFindIndexTopicYou can use the following values for navigator: TableOfContents, Find, Index, or Topic.

您可以使用param來提供進一步Topic的命令精簡。You can use param to provide further refinement of the Topic command. 如果navigator參數中指定的值為TableOfContentsIndexFind, 則這個值應該是nullIf the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. 如果參數參考Topic, 此值應參考包含要顯示之主題數值的物件。 navigatorIf the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

helpFilePath參數的格式可以是 C:\path\sample.chm 或/folder/file.htm。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

安全性

UIPermission
適用于安全的子視窗來呼叫這個方法。for safe subwindows to call this method. 相關聯的列舉:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
透過 HTTP 要求存取 HTML 說明檔。to access a HTML help file through a HTTP request. 相關聯的列舉:ConnectAssociated enumeration: Connect

SecurityPermission
存取不是從 HTTP 伺服器提供的 HTML 說明檔。to access a HTML help file not served from a HTTP server. 相關聯的列舉:UnmanagedCodeAssociated enumeration: UnmanagedCode

另請參閱

適用於