Interaction.MsgBox(Object, MsgBoxStyle, Object) Metode

Definisi

Ruang nama:

Microsoft.VisualBasic

Rakitan:

Microsoft.VisualBasic.Core.dll

Sumber:

Interaction.vb

Menampilkan pesan dalam kotak dialog, menunggu pengguna mengklik tombol, lalu mengembalikan bilangan bulat yang menunjukkan tombol mana yang diklik pengguna.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);

static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult

Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult

Parameter

Prompt

Object

Wajib diisi. String ekspresi ditampilkan sebagai pesan dalam kotak dialog. Panjang Prompt maksimum adalah sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika Prompt terdiri dari lebih dari satu baris, Anda dapat memisahkan garis menggunakan karakter pengangkutan kembali (Chr(13)), karakter umpan baris (Chr(10)), atau kombinasi karakter kembali/umpan garis pengangkutan (Chr(13) & Chr(10)) di antara setiap baris.

Buttons

MsgBoxStyle

Opsional. Ekspresi numerik yang merupakan jumlah nilai yang menentukan jumlah dan jenis tombol untuk ditampilkan, gaya ikon yang akan digunakan, identitas tombol default, dan modalitas kotak pesan. Jika Anda menghilangkan Buttons, nilai defaultnya adalah nol.

Title

Object

Pilihan. String ekspresi ditampilkan di bilah judul kotak dialog. Jika Anda menghilangkan Title, nama aplikasi ditempatkan di bilah judul.

Mengembalikan

MsgBoxResult

Salah satu dari nilai berikut:

Terus-menerus	Nilai
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Pengecualian

ArgumentException

Prompt bukan String ekspresi, atau Title tidak valid.

InvalidOperationException

Proses tidak berjalan dalam mode Interaktif Pengguna.

InvalidEnumArgumentException

Satu atau beberapa parameter bukan anggota MsgBoxResult atau MsgBoxStyle enumerasi.

Contoh

Contoh ini menggunakan MsgBox fungsi untuk menampilkan pesan kritis-kesalahan dalam kotak dialog dengan tombol Ya dan Tidak. Tombol Tidak ditentukan sebagai respons default. Ini dilakukan dengan menggabungkan MsgBox nilai konstanta ke dalam satu ekspresi numerik. Dalam hal ini, menambahkan 4 (kombinasi tombol Ya/Tidak) dan 16 (jendela Pesan Penting ) dan 256 (tombol kedua sebagai tombol default) memberikan total 276. Nilai yang dikembalikan oleh MsgBox fungsi tergantung pada tombol yang dipilih oleh pengguna: Ya mengembalikan nilai 6; Tidak mengembalikan nilai 7.

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

Keterangan

Jika Anda menghilangkan argumen posisi, Anda harus mempertahankan pemisah koma yang sesuai.

Jika kotak dialog menampilkan tombol Batal , menekan tombol ESC memiliki efek yang sama seperti mengklik Batal

Jika kotak dialog berisi tombol Bantuan , Bantuan peka konteks disediakan untuk kotak dialog. Namun, tidak ada nilai yang dikembalikan sampai salah satu tombol lain dipilih. Di aplikasi Formulir Windows, memilih tombol Bantuan menjalankan HelpRequested peristiwa untuk formulir.

Catatan

Fungsi ini MsgBox membutuhkan UIPermission pada SafeTopLevelWindows tingkat , yang dapat memengaruhi eksekusinya dalam situasi kepercayaan parsial. Untuk informasi selengkapnya, lihat UIPermission.

Nilai MsgBoxStyle enumerasi tercantum dalam tabel berikut ini.

Anggota	Nilai	Deskripsi
Anggota	Nilai	Deskripsi
OKOnly	0	Hanya menampilkan tombol OK.
OKCancel	1	Menampilkan tombol OK dan Batal.
AbortRetryIgnore	2	Menampilkan tombol Batalkan, Coba Lagi, dan Abaikan.
YesNoCancel	3	Menampilkan tombol Ya, Tidak, dan Batal.
YesNo	4	Menampilkan tombol Ya dan Tidak.
RetryCancel	5	Menampilkan tombol Coba Lagi dan Batal.
Critical	16	Menampilkan ikon Pesan Penting.
Question	32	Menampilkan ikon Kueri Peringatan.
Exclamation	48	Menampilkan ikon Pesan Peringatan.
Information	64	Menampilkan ikon Pesan Informasi.
DefaultButton1	0	Tombol pertama adalah default.
DefaultButton2	256	Tombol kedua adalah default.
DefaultButton3	512	Tombol ketiga adalah default.
ApplicationModal	0	Aplikasi modal. Pengguna harus merespons kotak pesan sebelum melanjutkan pekerjaan di aplikasi saat ini.
SystemModal	4096	Sistem bersifat modal. Semua aplikasi ditangguhkan hingga pengguna merespons kotak pesan.
MsgBoxSetForeground	65536	Menentukan jendela kotak pesan sebagai jendela latar depan.
MsgBoxRight	524288	Teks rata kanan.
MsgBoxRtlReading	1048576	Menentukan teks akan muncul sebagai pembacaan kanan-ke-kiri pada sistem Ibrani dan Arab.

Grup nilai pertama (0-5) menjelaskan jumlah dan jenis tombol yang ditampilkan dalam kotak dialog. Grup kedua (16, 32, 48, 64) menjelaskan gaya ikon. Grup ketiga (0, 256, 512) menentukan tombol mana yang merupakan default. Grup keempat (0, 4096) menentukan modalitas kotak pesan, dan grup kelima menentukan apakah jendela kotak pesan adalah jendela latar depan atau tidak, bersama dengan perataan dan arah teks. Saat menambahkan angka untuk membuat nilai akhir untuk Buttons argumen, gunakan hanya satu angka dari setiap grup.

Lihat juga

• InputBox(String, String, String, Int32, Int32)
• Show(String)