Fungsi MessageBoxA (winuser.h)

Menampilkan kotak dialog modal yang berisi ikon sistem, sekumpulan tombol, dan pesan khusus aplikasi singkat, seperti status atau informasi kesalahan. Kotak pesan mengembalikan nilai bilangan bulat yang menunjukkan tombol mana yang diklik pengguna.

Sintaksis

int MessageBoxA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType
);

Parameter

[in, optional] hWnd

Jenis: HWND

Handel ke jendela pemilik kotak pesan yang akan dibuat. Jika parameter ini NULL, kotak pesan tidak memiliki jendela pemilik.

[in, optional] lpText

Jenis: LPCTSTR

Pesan yang akan ditampilkan. Jika string terdiri dari lebih dari satu baris, Anda dapat memisahkan garis menggunakan karakter pengembalian gerbong dan/atau linefeed di antara setiap baris.

[in, optional] lpCaption

Jenis: LPCTSTR

Judul kotak dialog. Jika parameter ini NULL , judul defaultnya adalah Kesalahan.

[in] uType

Jenis: UINT

Konten dan perilaku kotak dialog. Parameter ini bisa menjadi kombinasi bendera dari grup bendera berikut.

Untuk menunjukkan tombol yang ditampilkan dalam kotak pesan, tentukan salah satu nilai berikut.

Untuk menampilkan ikon dalam kotak pesan, tentukan salah satu nilai berikut.

Untuk menunjukkan tombol default, tentukan salah satu nilai berikut.

Untuk menunjukkan modalitas kotak dialog, tentukan salah satu nilai berikut.

Untuk menentukan opsi lain, gunakan satu atau beberapa nilai berikut.

Mengembalikan nilai

Jenis: int

Jika kotak pesan memiliki tombol batalkan , fungsi mengembalikan nilai IDCANCEL jika tombol ESC ditekan atau tombol Batalkan dipilih. Jika kotak pesan tidak memiliki tombol Batalkan, menekan ESC tidak akan berpengaruh - kecuali tombol MB_OK ada. Jika tombol MB_OK ditampilkan dan pengguna menekan ESC, nilai pengembalian akan IDOK.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Jika fungsi berhasil, nilai yang dikembalikan adalah salah satu nilai item menu berikut.

Komentar

Ikon sistem berikut dapat digunakan dalam kotak pesan dengan mengatur parameter uType ke nilai bendera yang sesuai.

Ikon	Bendera nilai
Ikon	MB_ICONHAND, MB_ICONSTOP, atau MB_ICONERROR
Ikon	MB_ICONQUESTION
Ikon	MB_ICONEXCLAMATION atau MB_ICONWARNING
Ikon	MB_ICONASTERISK atau MB_ICONINFORMATION

Menambahkan dua tanda kanan-ke-kiri (RLM), yang diwakili oleh karakter pemformatan Unicode U+200F, di awal string tampilan MessageBox ditafsirkan oleh mesin penyajian MessageBox sehingga menyebabkan urutan pembacaan MessageBox dirender sebagai kanan-ke-kiri (RTL).

Saat Anda menggunakan kotak pesan modal sistem untuk menunjukkan bahwa sistem kehabisan memori, string yang ditunjukkan oleh lpText dan parameter lpCaption tidak boleh diambil dari file sumber daya karena upaya untuk memuat sumber daya mungkin gagal.

Jika Anda membuat kotak pesan saat kotak dialog ada, gunakan handel ke kotak dialog sebagai parameter hWnd. Parameter hWnd tidak boleh mengidentifikasi jendela anak, seperti kontrol dalam kotak dialog.

Contoh

Dalam contoh berikut, aplikasi menampilkan kotak pesan yang meminta tindakan kepada pengguna setelah kondisi kesalahan terjadi. Kotak pesan menampilkan pesan yang menjelaskan kondisi kesalahan dan cara mengatasinya. Gaya MB_CANCELTRYCONTINUE mengarahkan MessageBox untuk menyediakan tiga tombol yang dapat dipilih pengguna untuk melanjutkan. Gaya MB_DEFBUTTON2 mengatur fokus default pada tombol kedua kotak pesan, dalam hal ini, tombol Coba Lagi.

int DisplayResourceNAMessageBox()
{
    int msgboxID = MessageBox(
        NULL,
        (LPCWSTR)L"Resource not available\nDo you want to try again?",
        (LPCWSTR)L"Account Details",
        MB_ICONWARNING | MB_CANCELTRYCONTINUE | MB_DEFBUTTON2
    );

    switch (msgboxID)
    {
    case IDCANCEL:
        // TODO: add code
        break;
    case IDTRYAGAIN:
        // TODO: add code
        break;
    case IDCONTINUE:
        // TODO: add code
        break;
    }

    return msgboxID;
}

Gambar berikut menunjukkan output dari contoh kode sebelumnya: