Dalam database desktop Access, fungsi ini MsgBox menampilkan pesan dalam kotak dialog, menunggu pengguna memilih tombol, dan mengembalikan Integer pesan yang menunjukkan tombol mana yang dipilih pengguna.
Sintaks
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Sintaks MsgBox fungsi memiliki argumen berikut:
| Argumen | Deskripsi |
|---|---|
prompt |
Diperlukan. Ekspresi string ditampilkan sebagai pesan dalam kotak dialog. Panjang prompt maksimal sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika prompt memiliki lebih dari satu baris, Anda dapat memisahkan baris menggunakan karakter carriage return (),Chr(13) karakter linefeed (Chr(10)), atau kombinasi carriage return-linefeed (Chr(13) & Chr(10)) di antara setiap baris. |
buttons |
Opsional. Ekspresi numerik yang merupakan jumlah nilai yang menentukan jumlah dan jenis tombol yang akan ditampilkan, gaya ikon yang akan digunakan, identitas tombol default, dan modalitas kotak pesan. Jika dihilangkan, nilai default untuk buttons adalah 0. |
title |
Opsional. Ekspresi string ditampilkan di bilah judul kotak dialog. Jika Anda menghilangkan title, nama aplikasi muncul di bilah judul. |
helpfile |
Opsional. Ekspresi string yang mengidentifikasi file Bantuan yang akan digunakan untuk menyediakan Bantuan peka konteks untuk kotak dialog. Jika helpfile disediakan, context juga harus disediakan. |
context |
Opsional. Ekspresi numerik yang merupakan nomor konteks Bantuan yang ditetapkan untuk topik Bantuan yang sesuai oleh penulis Bantuan. Jika context disediakan, helpfile juga harus disediakan. |
Pengaturan
Pengaturan argumen adalah buttons :
| Konstanta | Nilai | Deskripsi |
|---|---|---|
vbOKOnly |
0 |
Tampilkan OK saja. |
vbOKCancel |
1 |
Tampilkan OK dan batal. |
vbAbortRetryIgnore |
2 |
Menampilkan Batalkan, Coba Lagi, dan Abaikan. |
vbYesNoCancel |
3 |
Tampilkan ya, tidak, dan batal. |
vbYesNo |
4 |
Tampilkan ya dan tidak. |
vbRetryCancel |
5 |
Tampilkan coba lagi dan batalkan. |
vbCritical |
16 |
Tampilkan ikon Pesan Penting . |
vbQuestion |
32 |
Tampilkan ikon Kueri Peringatan . |
vbExclamation |
48 |
Tampilkan ikon Pesan Peringatan . |
vbInformation |
64 |
Tampilkan ikon Pesan Informasi . |
vbDefaultButton1 |
0 |
Jadikan tombol pertama sebagai default. |
vbDefaultButton2 |
256 |
Jadikan tombol kedua sebagai default. |
vbDefaultButton3 |
512 |
Jadikan tombol ketiga sebagai default. |
vbDefaultButton4 |
768 |
Jadikan tombol keempat sebagai default. |
vbApplicationModal |
0 |
Modal aplikasi. Pengguna harus merespons kotak pesan sebelum melanjutkan pekerjaan di aplikasi saat ini. |
vbSystemModal |
4096 |
Sistem modal. Semua aplikasi ditangguhkan hingga pengguna merespons kotak pesan. |
vbMsgBoxHelpButton |
16384 |
Tambahkan tombol Bantuan ke kotak pesan. |
VbMsgBoxSetForeground |
65536 |
Tentukan jendela kotak pesan sebagai jendela latar depan. |
vbMsgBoxRight |
524288 |
Ratakan kanan teks. |
vbMsgBoxRtlReading |
1048576 |
Buat teks muncul dengan bacaan kanan ke kiri pada sistem Ibrani dan Arab. |
Grup nilai pertama (0 hingga 5) menjelaskan jumlah dan tipe tombol yang ditampilkan dalam kotak dialog. Grup kedua (16, 32, , 4864) menjelaskan gaya ikon. Grup ketiga (0, 256, ) 512menentukan tombol mana yang merupakan default. Grup keempat (0, 4096) menentukan modalitas kotak pesan. Saat Anda menambahkan angka untuk membuat nilai akhir argumen buttons , gunakan hanya satu angka dari setiap grup.
Catatan
Konstanta ini ditentukan oleh Visual Basic untuk Applications. Akibatnya, Anda dapat menggunakan nama di mana saja dalam kode, bukan nilai sebenarnya.
Mengembalikan nilai
| Konstanta | Nilai | Deskripsi |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Batal |
vbAbort |
3 |
Membatalkan |
vbRetry |
4 |
Coba lagi |
vbIgnore |
5 |
Abaikan |
vbYes |
6 |
Ya |
vbNo |
7 |
Tidak |
Keterangan
Ketika keduanya helpfile dan context disediakan, pengguna dapat menekan F1 di Windows atau Bantuan di macOS untuk melihat topik Bantuan yang cocok dengan context. Beberapa aplikasi host, seperti Microsoft Excel, juga secara otomatis menambahkan tombol Bantuan ke kotak dialog.
Jika kotak dialog menampilkan tombol Batal , menekan Esc memiliki efek yang sama seperti memilih Batal. Jika kotak dialog berisi tombol Bantuan , Bantuan peka konteks disediakan untuk kotak dialog. Namun, tidak ada nilai yang dikembalikan hingga pengguna memilih salah satu tombol lainnya.
Catatan
Untuk menentukan lebih dari argumen bernama pertama, Anda harus menggunakannya MsgBox dalam ekspresi. Untuk menghilangkan beberapa argumen posisi, Anda harus menyertakan pemisah koma yang sesuai.
Contoh
Catatan
Contoh berikut menunjukkan cara menggunakan fungsi ini dalam modul Visual Basic for Applications (VBA).
Contoh ini menggunakan fungsi untuk MsgBox menampilkan pesan kesalahan kritis dalam kotak dialog dengan tombol Ya dan Tidak . Tombol Tidak ditentukan sebagai respons default. Nilai yang dihasilkan oleh fungsi tergantung MsgBox pada tombol yang dipilih pengguna. Contoh ini mengasumsikan bahwa itu DEMO.HLP adalah file Bantuan yang berisi topik dengan nomor konteks Bantuan sama dengan 1000.
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If