Dalam database desktop Access, MsgBox fungsi menampilkan pesan dalam kotak dialog, menunggu pengguna memilih tombol, dan mengembalikan tombol Integer yang menunjukkan tombol mana yang dipilih pengguna.
Sintaks
MsgBox(prompt[, buttons][, title][, helpfile][, context])
MsgBox Sintaks fungsi memiliki argumen ini:
| Argumen | Deskripsi |
|---|---|
prompt |
Diperlukan. Ekspresi string ditampilkan sebagai pesan dalam kotak dialog. Panjang prompt maksimum adalah sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika prompt memiliki lebih dari satu baris, Anda dapat memisahkan garis menggunakan karakter kembali gerbong (Chr(13)), karakter linefeed (Chr(10)), atau kombinasiChr(13) & Chr(10) umpan kembali () di antara setiap baris. |
buttons |
Opsional. Ekspresi numerik yang merupakan jumlah nilai yang menentukan jumlah dan tipe tombol untuk ditampilkan, gaya ikon yang akan digunakan, identitas tombol default, dan modalitas kotak pesan. Jika dihilangkan, nilai defaultnya 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 untuk digunakan guna menyediakan Bantuan peka konteks untuk kotak dialog. Jika helpfile sudah disediakan, context juga harus disediakan. |
context |
Opsional. Ekspresi numerik yang merupakan nomor konteks Bantuan yang ditetapkan ke topik Bantuan yang sesuai oleh penulis Bantuan. Jika context sudah disediakan, helpfile juga harus disediakan. |
Pengaturan
Pengaturan buttons argumennya adalah:
| Konstanta | Nilai | Deskripsi |
|---|---|---|
vbOKOnly |
0 |
Tampilkan OK saja. |
vbOKCancel |
1 |
Tampilkan OK dan Batalkan. |
vbAbortRetryIgnore |
2 |
Tampilkan Batalkan, Coba Lagi, dan Abaikan. |
vbYesNoCancel |
3 |
Tampilkan Ya, Tidak, dan Batalkan. |
vbYesNo |
4 |
Tampilkan Ya dan Tidak. |
vbRetryCancel |
5 |
Tampilkan Coba Lagi dan Batalkan. |
vbCritical |
16 |
Menampilkan ikon Pesan Penting . |
vbQuestion |
32 |
Menampilkan ikon Kueri Peringatan . |
vbExclamation |
48 |
Menampilkan ikon Pesan Peringatan . |
vbInformation |
64 |
Menampilkan 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 |
Modal sistem. Semua aplikasi ditangguhkan hingga pengguna merespons kotak pesan. |
vbMsgBoxHelpButton |
16384 |
Tombol Tambahkan Bantuan ke kotak pesan. |
VbMsgBoxSetForeground |
65536 |
Tentukan jendela kotak pesan sebagai jendela latar depan. |
vbMsgBoxRight |
524288 |
Meratakan teks ke kanan. |
vbMsgBoxRtlReading |
1048576 |
Buat teks muncul dengan pembacaan kanan ke kiri pada sistem Ibrani dan Arab. |
Grup nilai pertama (0 melalui 5) menguraikan jumlah dan tipe tombol yang ditampilkan dalam kotak dialog. Grup kedua (16, 32, 48, ) 64menjelaskan gaya ikon. Grup ketiga (0, 256, ) 512menentukan tombol mana yang menjadi default. Grup keempat (0, 4096) menentukan modalitas kotak pesan. Saat Anda menambahkan angka untuk membuat nilai akhir untuk argumen, buttons gunakan hanya satu angka dari setiap grup.
Catatan
Konstanta ini ditentukan oleh Visual Basic for Applications. Sebagai hasilnya, Anda dapat menggunakan nama di mana saja dalam kode, bukan nilai aktual.
Mengembalikan nilai
| 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 keduanya helpfile dan context disediakan, pengguna dapat menekan F1 di Windows atau Bantuan di macOS untuk menampilkan topik Bantuan yang cocok context. Beberapa aplikasi host, seperti Microsoft Excel, juga secara otomatis menambahkan tombol Bantuan ke kotak dialog.
Jika kotak dialog menampilkan tombol Batalkan , menekan Esc memiliki efek yang sama seperti memilih Batalkan. 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 terkait.
Contoh
Catatan
Contoh berikut ini menunjukkan cara menggunakan fungsi ini dalam modul Visual Basic for Applications (VBA).
Contoh ini menggunakan MsgBox fungsi untuk menampilkan pesan kesalahan kritis dalam kotak dialog dengan tombol Ya dan Tidak . Tombol Tidak ditentukan sebagai respons default. Nilai yang MsgBox dikembalikan oleh fungsi bergantung pada tombol yang dipilih 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