Fungsi MessageBoxExA (winuser.h)

Artikel
03/04/2024

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

Saat ini MessageBoxEx dan MessageBox berfungsi dengan cara yang sama.

Sintaks

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 ADALAH 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 adalah 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.

Nilai kembali

Jenis: int

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

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi 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 Batal dipilih.
IDCONTINUE 11	Tombol Lanjutkan dipilih.
IDIGNORE 5	Tombol Abaikan dipilih.
IDNO 7	Tombol Tidak dipilih.
IDOK 1	Tombol OK dipilih.
IDRETRY 4	Tombol Coba Lagi dipilih.
IDTRYAGAIN 10	Tombol Coba Lagi dipilih.
IDYES 6	Tombol Ya dipilih.

Keterangan

Ketika Anda menggunakan kotak pesan modal sistem untuk menunjukkan bahwa sistem kehabisan memori, string yang ditunjukkan oleh parameter lpText dan 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.

Catatan

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll