MessageBox.Show Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menampilkan kotak pesan.

Overload

Show(String)	Menampilkan kotak pesan dengan teks yang ditentukan.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan dan kata kunci Bantuan yang ditentukan.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan, `HelpNavigator`, dan topik Bantuan.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan dan `HelpNavigator`.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan dan kata kunci Bantuan yang ditentukan.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, tombol, ikon, tombol default, dan opsi yang ditentukan.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan dan `HelpNavigator`.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, tombol, ikon, dan tombol default yang ditentukan.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, tombol, dan ikon yang ditentukan.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, dan tombol default yang ditentukan.
Show(IWin32Window, String, String, MessageBoxButtons)	Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, dan tombol yang ditentukan.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Menampilkan kotak pesan dengan teks, caption, tombol, dan ikon tertentu.
Show(IWin32Window, String, String)	Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks dan caption yang ditentukan.
Show(String, String, MessageBoxButtons)	Menampilkan kotak pesan dengan teks, caption, dan tombol tertentu.
Show(IWin32Window, String)	Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks yang ditentukan.
Show(String, String)	Menampilkan kotak pesan dengan teks dan caption tertentu.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, dan opsi yang ditentukan.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan, `HelpNavigator`, dan topik Bantuan.

Show(String)

Menampilkan kotak pesan dengan teks yang ditentukan.

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

public static System.Windows.Forms.DialogResult Show (string text);

public static System.Windows.Forms.DialogResult Show (string? text);

static member Show : string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Contoh

Contoh kode berikut menampilkan kotak pesan sederhana.

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

Private Sub DisplayMessageBoxText()

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

Keterangan

Secara default, kotak pesan menampilkan tombol OK . Kotak pesan tidak berisi caption dalam judul.

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan dan kata kunci Bantuan yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

keyword: String

Kata kunci Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan yang diindukkan ke jendela utama. Kotak pesan menampilkan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka dan topik yang diidentifikasi oleh mspaint.chm::/paint_brush.htm kata kunci ditampilkan. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");

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

Keterangan

Kotak pesan adalah kotak dialog modal, yang berarti tidak ada input (keyboard atau klik mouse) yang dapat terjadi kecuali objek pada formulir modal. Program harus menyembunyikan atau menutup formulir modal (biasanya sebagai respons terhadap beberapa tindakan pengguna) sebelum input ke formulir lain dapat terjadi. Anda dapat menggunakan owner parameter untuk menentukan objek tertentu, yang mengimplementasikan IWin32Window antarmuka, yang akan berfungsi sebagai pemilik tingkat atas kotak dialog.

Saat pengguna mengklik tombol Bantuan, file Bantuan yang ditentukan dalam helpFilePath parameter dibuka dan topik kata kunci Bantuan yang diidentifikasi oleh keyword parameter ditampilkan. Formulir yang memiliki kotak pesan (atau formulir aktif) juga menerima peristiwa tersebut HelpRequested .

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan, HelpNavigator, dan topik Bantuan.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

navigator: HelpNavigator

Salah HelpNavigator satu nilai.

param: Object

ID numerik topik Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan dengan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka dan tab Indeks bantuan dan topik yang diidentifikasi oleh ovals kata kunci ditampilkan. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

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

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

Keterangan

Saat pengguna mengklik tombol Bantuan, file Bantuan yang ditentukan dalam helpFilePath parameter dibuka dan konten Bantuan yang diidentifikasi oleh navigator parameter ditampilkan. Formulir yang memiliki kotak pesan (atau formulir aktif) juga menerima peristiwa tersebut HelpRequested .

File bantuan yang dikompilasi menyediakan daftar isi, indeks, pencarian, dan tautan kata kunci di halaman. Anda dapat menggunakan nilai berikut untuk navigator: , , Find Index, atau Topic TableOfContents.

Anda dapat menggunakan param untuk memberikan penyempurnaan Topic perintah lebih lanjut. Jika nilai yang ditentukan dalam navigator parameter adalah TableOfContents, , Indexatau Find, nilai ini harus null. Jika parameter mereferensikan navigatorTopic, nilai ini harus mereferensikan objek yang berisi nilai numerik topik yang akan ditampilkan.

Parameter helpFilePath dapat berupa C:\path\sample.chm atau /folder/file.htm.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan yang diindukkan ke formulir utama. Kotak pesan menampilkan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");

' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Keterangan

Saat pengguna mengklik tombol Bantuan, file Bantuan yang ditentukan dalam helpFilePath parameter dibuka. Formulir yang memiliki kotak pesan (atau formulir aktif) juga menerima peristiwa tersebut HelpRequested .

Parameter helpFilePath dapat berupa C:\path\sample.chm atau /folder/file.htm.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan dan HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

navigator: HelpNavigator

Salah HelpNavigator satu nilai.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan dengan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka dan tab Indeks bantuan ditampilkan. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

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

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

Keterangan

Saat pengguna mengklik tombol Bantuan, file bantuan yang ditentukan dalam helpFilePath parameter dibuka dan konten Bantuan yang diidentifikasi oleh navigator parameter ditampilkan. Formulir yang memiliki kotak pesan (atau formulir aktif) juga menerima peristiwa tersebut HelpRequested .

File Bantuan yang dikompilasi menyediakan daftar isi, indeks, pencarian, dan tautan kata kunci di halaman. Anda dapat menggunakan nilai berikut untuk navigator: , , Find Index, atau Topic TableOfContents.

Parameter helpFilePath dapat berupa C:\path\sample.chm atau /folder/file.htm.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan dan kata kunci Bantuan yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

keyword: String

Kata kunci Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan dengan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka dan topik yang diidentifikasi oleh mspaint.chm::/paint_brush.htm kata kunci ditampilkan. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");

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

Keterangan

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, tombol, ikon, tombol default, dan opsi yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

defaultButton bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

optionsDefaultDesktopOnly menentukan atau ServiceNotification dan menentukan nilai dalam owner parameter . Kedua opsi ini harus digunakan hanya jika Anda memanggil versi metode ini yang tidak mengambil owner parameter.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara menampilkan dengan opsi yang MessageBox didukung oleh kelebihan beban ini.Show Setelah memverifikasi bahwa variabel string, ServerName, kosong, contoh menampilkan MessageBox, menawarkan opsi kepada pengguna untuk membatalkan operasi. Show Jika nilai pengembalian metode mengevaluasi ke Yes, formulir yang menampilkan MessageBox ditutup.

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

Keterangan

Anda dapat menggunakan owner parameter untuk menentukan objek tertentu, yang mengimplementasikan IWin32Window antarmuka, yang akan berfungsi sebagai jendela dan pemilik tingkat atas kotak dialog. Kotak pesan adalah kotak dialog modal, yang berarti tidak ada input (keyboard atau klik mouse) yang dapat terjadi kecuali objek pada formulir modal. Program harus menyembunyikan atau menutup formulir modal (biasanya sebagai respons terhadap beberapa tindakan pengguna) sebelum input ke formulir lain dapat terjadi.

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan dengan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");

' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Keterangan

Parameter helpFilePath dapat berupa C:\path\sample.chm atau /folder/file.htm.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

displayHelpButton: Boolean

true untuk menampilkan tombol Bantuan; jika tidak, false. Default adalah false.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan dengan tombol Bantuan, menangani Control.HelpRequested peristiwa, dan memperlihatkan jendela bantuan kustom sebagai respons terhadap peristiwa tersebut.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

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

// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

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

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

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

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

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

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

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

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

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

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

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

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

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}

' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

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

    Me.Tag = "Message with Help button."

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

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

    ' Return the dialog box result.
    Return r
End Function

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

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

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

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

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

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

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

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

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

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

Keterangan

Saat pengguna mengklik tombol Bantuan, formulir yang memiliki kotak pesan (atau formulir aktif) menerima peristiwa tersebut HelpRequested . HelpRequested Tangani peristiwa untuk melakukan tindakan Bantuan kustom.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan dan HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

navigator: HelpNavigator

Salah HelpNavigator satu nilai.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara memperlihatkan kotak pesan yang diindukkan ke jendela utama. Kotak pesan menampilkan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka dan tab Indeks bantuan ditampilkan. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

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

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

Keterangan

Parameter helpFilePath dapat berupa C:\path\sample.chm atau /folder/file.htm.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, tombol, ikon, dan tombol default yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

defaultButton bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

Contoh

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, tombol, dan ikon yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

Contoh

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, dan tombol default yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

defaultButton bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

Contoh

Contoh kode berikut menunjukkan cara menampilkan dengan opsi yang MessageBox didukung oleh kelebihan beban ini.Show Setelah memverifikasi bahwa variabel string, ServerName, kosong, contoh menampilkan MessageBox dengan ikon kotak pertanyaan, menawarkan opsi kepada pengguna untuk membatalkan operasi. Show Jika nilai pengembalian metode mengevaluasi ke Yes, formulir yang menampilkan MessageBox ditutup.

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

Berlaku untuk

Show(IWin32Window, String, String, MessageBoxButtons)

Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks, caption, dan tombol yang ditentukan.

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

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

Contoh

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

MessageBoxButtons

Berlaku untuk

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Menampilkan kotak pesan dengan teks, caption, tombol, dan ikon tertentu.

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

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

Parameter buttons yang ditentukan bukan anggota .MessageBoxButtons

-atau-

Parameter icon yang ditentukan bukan anggota .MessageBoxIcon

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

Contoh

Contoh kode berikut menunjukkan salah Show satu metode saat menangani ComboBox.DropDown peristiwa. Untuk menjalankan contoh, tempelkan kode berikut dalam formulir dan panggil InitializeComboBox metode dari konstruktor atau Load metode formulir.

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

Berlaku untuk

Show(IWin32Window, String, String)

Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks dan caption yang ditentukan.

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

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);

static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Keterangan

Secara default, kotak pesan menampilkan tombol OK .

Berlaku untuk

Show(String, String, MessageBoxButtons)

Menampilkan kotak pesan dengan teks, caption, dan tombol tertentu.

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

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

Parameter buttons yang ditentukan bukan anggota .MessageBoxButtons

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

Contoh

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

MessageBoxButtons

Berlaku untuk

Show(IWin32Window, String)

Menampilkan kotak pesan di depan objek yang ditentukan dan dengan teks yang ditentukan.

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

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);

static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Keterangan

Secara default, kotak pesan menampilkan tombol OK . Kotak pesan tidak berisi caption dalam judul.

Berlaku untuk

Show(String, String)

Menampilkan kotak pesan dengan teks dan caption tertentu.

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

public static System.Windows.Forms.DialogResult Show (string text, string caption);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption);

static member Show : string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Keterangan

Secara default, kotak pesan menampilkan tombol OK .

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, dan opsi yang ditentukan.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameter

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

Yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara menampilkan dengan opsi yang MessageBox didukung oleh kelebihan beban ini.Show Setelah memverifikasi bahwa variabel string, ServerName, kosong, contoh menampilkan MessageBox dengan ikon kotak pertanyaan, menawarkan opsi kepada pengguna untuk membatalkan operasi. Contoh menggunakan RightAlign anggota MessageBoxOptions enumerasi untuk meratakan teks ke tepi kanan kotak dialog. Show Jika nilai pengembalian metode mengevaluasi ke Yes, formulir yang menampilkan MessageBox ditutup.

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

Keterangan

Anda dapat memiliki maksimal tiga tombol pada kotak pesan.

Lihat juga

Berlaku untuk

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

Menampilkan kotak pesan dengan teks, caption, tombol, ikon, tombol default, opsi, dan tombol Bantuan yang ditentukan, menggunakan file Bantuan yang ditentukan, HelpNavigator, dan topik Bantuan.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameter

owner: IWin32Window

Implementasi IWin32Window yang akan memiliki kotak dialog modal.

text: String

Teks yang akan ditampilkan dalam kotak pesan.

caption: String

Teks yang akan ditampilkan di bilah judul kotak pesan.

buttons: MessageBoxButtons

Salah MessageBoxButtons satu nilai yang menentukan tombol mana yang akan ditampilkan dalam kotak pesan.

icon: MessageBoxIcon

Salah MessageBoxIcon satu nilai yang menentukan ikon mana yang akan ditampilkan dalam kotak pesan.

defaultButton: MessageBoxDefaultButton

Salah MessageBoxDefaultButton satu nilai yang menentukan tombol default untuk kotak pesan.

options: MessageBoxOptions

Salah MessageBoxOptions satu nilai yang menentukan opsi tampilan dan asosiasi mana yang akan digunakan untuk kotak pesan. Anda dapat meneruskan 0 jika Anda ingin menggunakan default.

helpFilePath: String

Jalur dan nama file Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

navigator: HelpNavigator

Salah HelpNavigator satu nilai.

param: Object

ID numerik topik Bantuan untuk ditampilkan saat pengguna mengklik tombol Bantuan.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidEnumArgumentException

buttons bukan anggota dari MessageBoxButtons.

-atau-

icon bukan anggota dari MessageBoxIcon.

-atau-

Yang defaultButton ditentukan bukan anggota dari MessageBoxDefaultButton.

InvalidOperationException

Upaya dilakukan untuk menampilkan MessageBox dalam proses yang tidak berjalan dalam mode Interaktif Pengguna. Ini ditentukan oleh UserInteractive properti .

ArgumentException

options ditentukan baik DefaultDesktopOnly dan ServiceNotification.

-atau-

buttons menentukan kombinasi yang tidak valid dari MessageBoxButtons.

Contoh

Contoh kode berikut menunjukkan cara menampilkan kotak pesan yang diindukkan ke jendela utama. Kotak pesan menampilkan tombol Bantuan. Saat pengguna mengklik tombol Bantuan, Mspaint.chm file Bantuan dibuka dan tab Indeks bantuan dan topik yang diidentifikasi oleh ovals kata kunci ditampilkan. Contohnya mengharuskan Mspaint.chm file Bantuan diinstal.

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

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

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

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

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

Keterangan

File bantuan yang dikompilasi menyediakan daftar isi, indeks, pencarian, dan tautan kata kunci di halaman. Anda dapat menggunakan nilai berikut untuk navigator: TableOfContents, , Find, Indexatau Topic.

Parameter helpFilePath dapat berupa C:\path\sample.chm atau /folder/file.htm.

Lihat juga

Berlaku untuk

Share via

MessageBox.Show Metode

Definisi

Overload

Show(String)

Parameter

Mengembalikan

Contoh

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan