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

Definition

メッセージ ボックスを表示します。 Displays a message box.

Overloads

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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Examples

次のコード例では、単純なメッセージ ボックスが表示されます。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

Remarks

既定では、メッセージ ボックスが表示されます、 OKボタンをクリックします。By default, the message box displays an OK button. メッセージ ボックスに、タイトルのキャプションが含まれていません。The message box does not contain a caption in the title.

Security

UIPermission
このプロパティを設定するセーフ サブウィンドウします。 for safe subwindows to set this property. 関連付けられた列挙体。 SafeSubWindows Associated 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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、親のメイン ウィンドウにメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box parented to the main window. メッセージ ボックスには、[ヘルプ] ボタンが表示されます。The message box displays a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれ、トピックがで識別される、mspaint.chm::/paint_brush.htmキーワードが表示されます。When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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 値のいずれか 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、ヘルプ ボタンを含むメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box with a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれるとヘルプ キーワード タブで識別されるトピック、ovalsキーワードが表示されます。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. プログラムを非表示にする必要がありますか、別のフォームに入力する前に (通常は、いくつかのユーザー アクションへの応答) のモーダル フォームを閉じることができます。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

指定されたヘルプ ファイルは、ユーザーは、[ヘルプ] ボタンをクリックすると、helpFilePathパラメーターが開かれ、ヘルプ コンテンツがで識別される、navigatorパラメーターが表示されます。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. また、メッセージ ボックス (またはアクティブなフォーム) を所有しているフォームを受け取ります、HelpRequestedイベント。The form that owns the message box (or the active form) also receives the HelpRequested event.

コンパイル済みヘルプ ファイルは、テーブルの内容、インデックス、検索、およびページ内のキーワードのリンクを提供します。Compiled help files provide table of contents, index, search, and keyword links in pages. 次の値を使用するnavigator: TableOfContentsFindIndex、またはTopicします。You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

使用することができますparamの洗練化をさらに提供する、Topicコマンド。You can use param to provide further refinement of the Topic command. 値が指定されている場合、navigatorパラメーターがTableOfContentsIndex、またはFind、この値はnullします。If the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. 場合、navigatorパラメーター参照Topic、この値は、表示するトピックの数値の値を格納しているオブジェクトを参照する必要があります。If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

helpFilePathフォーム C:\path\sample.chm または/folder/file.htm のパラメーターを指定できます。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、親、メイン フォームがメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box that parented to the main form. メッセージ ボックスには、[ヘルプ] ボタンが表示されます。The message box displays a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれます。When the user clicks the Help button, the Mspaint.chm Help file is opened. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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 値のいずれか 1 つ。 One of the HelpNavigator values.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、ヘルプ ボタンを含むメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box with a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれ、ヘルプのキーワード タブが表示されます。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. プログラムを非表示にする必要がありますか、別のフォームに入力する前に (通常は、いくつかのユーザー アクションへの応答) のモーダル フォームを閉じることができます。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

指定されたヘルプ ファイルは、ユーザーは、[ヘルプ] ボタンをクリックすると、helpFilePathパラメーターが開かれ、ヘルプ コンテンツがで識別される、navigatorパラメーターが表示されます。When the user clicks the Help button, the help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. また、メッセージ ボックス (またはアクティブなフォーム) を所有しているフォームを受け取ります、HelpRequestedイベント。The form that owns the message box (or the active form) also receives the HelpRequested event.

コンパイル済みヘルプ ファイルは、テーブルの内容、インデックス、検索、およびページ内のキーワードのリンクを提供します。Compiled Help files provide table of contents, index, search, and keyword links in pages. 次の値を使用するnavigator: TableOfContentsFindIndex、またはTopicします。You 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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、ヘルプ ボタンを含むメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box with a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれ、トピックがで識別される、mspaint.chm::/paint_brush.htmキーワードが表示されます。When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values the specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- defaultButtonMessageBoxDefaultButton のメンバーではありません。 defaultButton is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- options に、DefaultDesktopOnly または ServiceNotification、および owner パラメーターの値が指定されています。 options specified DefaultDesktopOnly or ServiceNotification and specified a value in the owner parameter. これら 2 つのオプションは、このメソッドの 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.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

private void validateUserEntry2()
{

	// Checks the value of the text.

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

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

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

		// Displays the MessageBox.

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

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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


        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarks

使用することができます、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.

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、ヘルプ ボタンを含むメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box with a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれます。When the user clicks the Help button, the Mspaint.chm Help file is opened. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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。それ以外の場合は false true to show the Help button; otherwise, false. 既定値は、false です。 The default is false.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例は、[ヘルプ] ボタンを含むメッセージ ボックスを表示するには、処理方法を示します、Control.HelpRequestedイベント、およびイベントへの応答でのカスタム ヘルプ ウィンドウを表示します。The following code example demonstrates how to show a message box with a Help button, handle the Control.HelpRequested event, and show a custom help window in response to the event.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Me.Tag = "Message with Help button."

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

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

    ' Return the dialog box result.
    Return r
End Function

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

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

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

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

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

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

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

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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 値のいずれか 1 つ。 One of the HelpNavigator values.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、親のメイン ウィンドウにメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box parented to the main window. メッセージ ボックスには、[ヘルプ] ボタンが表示されます。The message box displays a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれ、ヘルプのキーワード タブが表示されます。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. プログラムを非表示にする必要がありますか、別のフォームに入力する前に (通常は、いくつかのユーザー アクションへの応答) のモーダル フォームを閉じることができます。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. 使用することができます、ownerを実装して、特定のオブジェクトを指定するパラメーター、IWin32Windowインターフェイス、ダイアログ ボックスの最上位ウィンドウと所有者として使用されます。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

指定されたヘルプ ファイルは、ユーザーは、[ヘルプ] ボタンをクリックすると、helpFilePathパラメーターが開かれ、ヘルプ コンテンツがで識別される、navigatorパラメーターが表示されます。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. また、メッセージ ボックス (またはアクティブなフォーム) を所有しているフォームを受け取ります、HelpRequestedイベント。The form that owns the message box (or the active form) also receives the HelpRequested event.

コンパイル済みヘルプ ファイルは、テーブルの内容、インデックス、検索、およびページ内のキーワードのリンクを提供します。Compiled Help files provide table of contents, index, search, and keyword links in pages. 次の値を使用するnavigator: TableOfContentsFindIndex、またはTopicします。You 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.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- defaultButtonMessageBoxDefaultButton のメンバーではありません。 defaultButton is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

private void validateUserEntry2()
{

	// Checks the value of the text.

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

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

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

		// Displays the MessageBox.

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

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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


        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarks

使用することができます、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.

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

	// Checks the value of the text.

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

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

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

		// Displays the MessageBox.

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

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarks

使用することができます、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.

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- defaultButtonMessageBoxDefaultButton のメンバーではありません。 defaultButton is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

	// Checks the value of the text.

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

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

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

		// Displays the MessageBox.

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

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}

Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Remarks

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

	// Checks the value of the text.

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

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

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

		// Displays the MessageBox.

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

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarks

使用することができます、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.

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

指定した 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.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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.

Examples

次のコード例では、いずれかを示します、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

Remarks

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Remarks

使用することができます、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.

既定では、メッセージ ボックスが表示されます、 OKボタンをクリックします。By default, the message box displays an OK button.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated 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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

指定した buttons パラメーターが、MessageBoxButtons のメンバーではありません。 The buttons parameter specified is not a member of MessageBoxButtons.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

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

private void validateUserEntry()
{

	// Checks the value of the text.

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

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

		string message = "You did not enter a server name. Cancel this operation?";
                       string caption = "Error Detected in Input";
		MessageBoxButtons buttons = MessageBoxButtons.YesNo;
		DialogResult result;

		// Displays the MessageBox.

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

		if (result == System.Windows.Forms.DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}

Private Sub ValidateUserEntry()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox

        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarks

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Remarks

使用することができます、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.

既定では、メッセージ ボックスが表示されます、 OKボタンをクリックします。By default, the message box displays an OK button. メッセージ ボックスに、タイトルのキャプションが含まれていません。The message box does not contain a caption in the title.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Remarks

既定では、メッセージ ボックスが表示されます、 OKボタンをクリックします。By default, the message box displays an OK button.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated 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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例は、表示する方法を示します、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. 場合、Showメソッドの戻り値を評価するYes、フォームが表示されるMessageBoxが閉じられました。If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

private void validateUserEntry2()
{

	// Checks the value of the text.

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

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

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

		// Displays the MessageBox.

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

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

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

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

        Dim Result As DialogResult

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

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


        ' Gets the result of the MessageBox display.

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

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Remarks

メッセージ ボックスには、最大 3 つのボタンがあります。You can have a maximum of three buttons on the message box.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

See Also

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 値の 1 つ。 One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon MessageBoxIcon MessageBoxIcon MessageBoxIcon

メッセージ ボックスに表示するアイコンを指定する MessageBoxIcon 値の 1 つ。 One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton MessageBoxDefaultButton

メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。 One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions MessageBoxOptions MessageBoxOptions MessageBoxOptions

メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。 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 値のいずれか 1 つ。 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.

Returns

DialogResult 値のいずれか 1 つ。 One of the DialogResult values.

Exceptions

buttonsMessageBoxButtons のメンバーではありません。 buttons is not a member of MessageBoxButtons. - または - -or- iconMessageBoxIcon のメンバーではありません。 icon is not a member of MessageBoxIcon. - または - -or- 指定した defaultButton が、MessageBoxDefaultButton のメンバーではありません。 The defaultButton specified is not a member of MessageBoxDefaultButton.

ユーザー対話モード以外のモードで実行されているプロセスで、MessageBox を表示しようとしました。 An 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 に、DefaultDesktopOnlyServiceNotification が両方指定されています。 options specified both DefaultDesktopOnly and ServiceNotification. - または - -or- buttons に、無効な MessageBoxButtons の組み合わせが指定されています。 buttons specified an invalid combination of MessageBoxButtons.

Examples

次のコード例では、親のメイン ウィンドウにメッセージ ボックスを表示する方法を示します。The following code example demonstrates how to show a message box parented to the main window. メッセージ ボックスには、[ヘルプ] ボタンが表示されます。The message box displays a Help button. ユーザーがヘルプ ボタンをクリックすると、Mspaint.chmヘルプ ファイルが開かれるとヘルプ キーワード タブで識別されるトピック、ovalsキーワードが表示されます。When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. この例では、する必要があります、Mspaint.chmヘルプ ファイルがインストールされています。The example requires that the Mspaint.chm Help file is installed.

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

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

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

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

Remarks

メッセージ ボックスは、入力 (キーボードやマウスのクリック) しか発生しませんモーダル フォーム上のオブジェクトには、モーダル ダイアログ ボックスです。A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. プログラムを非表示にする必要がありますか、別のフォームに入力する前に (通常は、いくつかのユーザー アクションへの応答) のモーダル フォームを閉じることができます。The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. 使用することができます、ownerを実装して、特定のオブジェクトを指定するパラメーター、IWin32Windowインターフェイス、ダイアログ ボックスの最上位ウィンドウと所有者として使用されます。You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

指定されたヘルプ ファイルは、ユーザーは、[ヘルプ] ボタンをクリックすると、helpFilePathパラメーターが開かれ、ヘルプ コンテンツがで識別される、navigatorパラメーターが表示されます。When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. また、メッセージ ボックス (またはアクティブなフォーム) を所有しているフォームを受け取ります、HelpRequestedイベント。The form that owns the message box (or the active form) also receives the HelpRequested event.

コンパイル済みヘルプ ファイルは、テーブルの内容、インデックス、検索、およびページ内のキーワードのリンクを提供します。Compiled help files provide table of contents, index, search, and keyword links in pages. 次の値を使用するnavigator: TableOfContentsFindIndex、またはTopicします。You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

使用することができますparamの洗練化をさらに提供する、Topicコマンド。You can use param to provide further refinement of the Topic command. 値が指定されている場合、navigatorパラメーターがTableOfContentsIndex、またはFind、この値はnullします。If the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. 場合、navigatorパラメーター参照Topic、この値は、表示するトピックの数値の値を格納しているオブジェクトを参照する必要があります。If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

helpFilePathフォーム C:\path\sample.chm または/folder/file.htm のパラメーターを指定できます。The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Security

UIPermission
このメソッドを呼び出すセーフ サブウィンドウします。 for safe subwindows to call this method. 関連付けられた列挙体。 SafeSubWindows Associated enumeration: SafeSubWindows

WebPermission
HTTP 要求を介して HTML ヘルプ ファイルにアクセスします。 to access a HTML help file through a HTTP request. 関連付けられた列挙体。 Connect Associated enumeration: Connect

SecurityPermission
HTML ヘルプ ファイルにアクセスするには、HTTP サーバーから提供されます。 to access a HTML help file not served from a HTTP server. 関連付けられた列挙体。 UnmanagedCode Associated enumeration: UnmanagedCode

See Also

Applies to