Bagikan melalui


Interaction.MsgBox(Object, MsgBoxStyle, Object) Metode

Definisi

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);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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

Salah satu dari nilai berikut:

Terus-menerusNilai
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Pengecualian

Prompt bukan String ekspresi, atau Title tidak valid.

Proses tidak berjalan dalam mode Interaktif Pengguna.

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.

Berlaku untuk

Lihat juga