Fungsi MessageBoxExA (winuser.h)

Membuat, menampilkan, dan mengoperasikan kotak pesan. Kotak pesan berisi pesan dan judul yang ditentukan aplikasi, ditambah kombinasi ikon dan tombol push yang telah ditentukan sebelumnya. Tombol berada dalam bahasa antarmuka pengguna sistem.

Saat ini MessageBoxEx dan MessageBox bekerja dengan cara yang sama.

Sintaksis

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

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.

[in, optional] lpCaption

Jenis: LPCTSTR

Judul kotak dialog. Jika parameter ini null, judul default Kesalahan digunakan.

[in] uType

Jenis: UINT

Konten dan perilaku kotak dialog. Untuk informasi tentang bendera yang didukung, lihat MessageBox.

[in] wLanguageId

Jenis: WORD

Bahasa untuk teks yang ditampilkan di tombol kotak pesan. Menentukan nilai nol (0) menunjukkan untuk menampilkan teks tombol dalam bahasa sistem default. Jika parameter ini MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL), bahasa saat ini yang terkait dengan utas panggilan digunakan.

Untuk menentukan bahasa selain bahasa saat ini, gunakan makro MAKELANGID untuk membuat parameter ini. Untuk informasi selengkapnya, lihat MAKELANGID.

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.

Mengembalikan kode/nilai	Deskripsi
IDABORT 3	Tombol Batalkan dipilih.
IDCANCEL 2	Tombol Batalkan dipilih.
IDCONTINUE 11	Tombol Lanjutkan dipilih.
IDIGNORE 5	Tombol Abaikan dipilih.
IDNO 7	Tombol Tidak ada yang dipilih.
IDOK 1	Tombol OK dipilih.
IDRETRY 4	Tombol Coba Lagi dipilih.
IDTRYAGAIN 10	Tombol Coba Lagi dipilih.
IDYES 6	Tombol Ya dipilih.

Komentar

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.

Nota

Header winuser.h mendefinisikan MessageBoxEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Konseptual

Kotak Dialog

MAKELANGID

MessageBeep

Kotak Pesan

MessageBoxIndirect

Sumber Daya Lain

Referensi

SetForegroundWindow