Dalam database desktop Access, Fungsi MsgBox menampilkan pesan dalam kotak dialog, menunggu pengguna mengklik tombol, dan mengembalikan Bilangan Bulat yang mengindikasikan tombol mana yang diklik pengguna.
Sintaks
MsgBox(prompt [, buttons ] [, title ] [, helpfile ] [, context ] )
Sintaks fungsi MsgBox memiliki argumen ini:
| Argumen | Deskripsi |
|---|---|
| Prompt | Diperlukan. Ekspresi string ditampilkan sebagai pesan dalam kotak dialog. Panjang maksimum prompt adalah sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika prompt terdiri dari lebih dari satu baris, Anda dapat memisahkan garis menggunakan karakter kembali gerbong (Chr(13)), karakter linefeed (Chr(10)), atau carriage return – kombinasi karakter linefeed (Chr(13) & Chr(10)) di antara setiap baris. |
| Tombol | Opsional. ekspresi numerik yang merupakan jumlah nilai yang menentukan jumlah dan tipe tombol untuk ditampilkan, gaya ikon yang digunakan, identitas tombol default, dan modalitas kotak pesan. Jika dihilangkan, nilai default untuk tombol adalah 0. |
| Judul | Opsional. Ekspresi string ditampilkan di bilah judul kotak dialog. Jika Anda menghilangkan judul, nama aplikasi ditempatkan di bilah judul. |
| helpfile | Opsional. Ekspresi string yang mengidentifikasi file Bantuan untuk digunakan guna menyediakan Bantuan peka konteks untuk kotak dialog. Jika helpfile disediakan, konteks juga harus disediakan. |
| Konteks | Opsional. Ekspresi numerik yang merupakan nomor konteks Bantuan yang ditetapkan ke topik Bantuan yang sesuai oleh penulis Bantuan. Jika konteks disediakan, helpfile juga harus disediakan. |
Pengaturan
Pengaturan argumen tomboladalah:
| Konstanta | Nilai | Deskripsi |
|---|---|---|
| vbOKOnly | 0 | Tampilkan tombol OK saja. |
| vbOKCancel | 1 | Menampilkan tombol OK dan Batalkan . |
| vbAbortRetryIgnore | 2 | Menampilkan tombol Batalkan, Coba Lagi, dan Abaikan . |
| vbYesNoCancel | 3 | Tampilkan tombol Ya, Tidak, dan Batalkan . |
| vbYesNo | 4 | Tombol Tampilkan Ya dan Tidak . |
| vbRetryCancel | 5 | Tampilkan tombol Coba Lagi dan Batalkan . |
| vbCritical | 16 | Tampilkan ikon Pesan Penting . |
| vbQuestion | 32 | Ikon Tampilkan Kueri Peringatan . |
| vbExclamation | 48 | Tampilkan ikon Pesan Peringatan . |
| vbInformation | 64 | Ikon Tampilkan Pesan Informasi . |
| vbDefaultButton1 | 0 | Tombol pertama adalah default. |
| vbDefaultButton2 | 256 | Tombol kedua adalah default. |
| vbDefaultButton3 | 512 | Tombol ketiga adalah default. |
| vbDefaultButton4 | 768 | Tombol keempat adalah default. |
| vbApplicationModal | 0 | Modal aplikasi; pengguna harus merespons kotak pesan sebelum melanjutkan pekerjaan di aplikasi saat ini. |
| vbSystemModal | 4096 | Modal sistem; semua aplikasi ditangguhkan hingga pengguna merespons kotak pesan. |
| vbMsgBoxHelpButton | 16384 | Tombol Tambahkan Bantuan ke kotak pesan |
| VbMsgBoxSetForeground | 65536 | Menentukan jendela kotak pesan sebagai jendela latar depan |
| vbMsgBoxRight | 524288 | Teks diratakan ke kanan |
| vbMsgBoxRtlReading | 1048576 | Menentukan teks akan muncul sebagai pembacaan kanan ke kiri pada sistem Bahasa Ibrani dan Arab |
Grup nilai pertama (0–5) menguraikan jumlah dan tipe 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; dan grup keempat (0, 4096) menentukan modalitas kotak pesan. Saat menambahkan angka untuk membuat nilai akhir untuk argumen tombol , gunakan hanya satu angka dari setiap grup.
Catatan
Konstanta ini ditentukan oleh Visual Basic for Applications. Sebagai hasilnya, nama dapat digunakan di mana saja dalam kode Anda sebagai ganti nilai aktual.
Nilai yang Dikembalikan
| Konstanta | Nilai | Deskripsi |
|---|---|---|
| vbOK | 1 | OK |
| vbCancel | 2 | Batal |
| vbAbort | 3 | Membatalkan |
| vbRetry | 4 | Coba lagi |
| vbIgnore | 5 | Mengabaikan |
| vbYes | 6 | Ya |
| vbNo | 7 | Tidak |
Keterangan
Saat kedua helpfile dan konteks disediakan, pengguna dapat menekan F1 (Windows) atau HELP (macOS) untuk menampilkan topik Bantuan yang sesuai dengan konteks. Beberapa aplikasi host, misalnya, Microsoft Excel, juga secara otomatis menambahkan tombol Bantuan ke kotak dialog.
Jika kotak dialog menampilkan tombol Batalkan , menekan tombol ESC memiliki efek yang sama seperti mengklik Batalkan. Jika kotak dialog berisi tombol Bantuan , Bantuan peka konteks disediakan untuk kotak dialog. Namun, tidak ada nilai yang dikembalikan hingga salah satu tombol lainnya diklik.
Catatan
Untuk menentukan lebih dari argumen bernama pertama, Anda harus menggunakan MsgBox dalam ekspresi. Untuk menghilangkan beberapa argumen posisi, Anda harus menyertakan pemisah koma terkait.
Contoh
Catatan
Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA).
Contoh ini menggunakan fungsi MsgBox untuk menampilkan pesan kesalahan kritis dalam kotak dialog dengan tombol Ya dan Tidak. Tombol Tidak ditentukan sebagai respons default. Nilai yang dikembalikan oleh fungsi MsgBox bergantung pada tombol yang dipilih oleh pengguna. Contoh ini mengasumsikan bahwa DEMO.HLP file Bantuan berisi topik dengan angka 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