Fungsi MessageBoxIndirectA (winuser.h)

Artikel
08/27/2023

Membuat, menampilkan, dan mengoperasikan kotak pesan. Kotak pesan berisi teks dan judul pesan yang ditentukan aplikasi, ikon apa pun, dan kombinasi tombol dorong yang telah ditentukan sebelumnya.

Sintaks

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

Parameter

[in] lpmbp

Jenis: const LPMSGBOXPARAMS

Penunjuk ke struktur MSGBOXPARAMS yang berisi informasi yang digunakan untuk menampilkan kotak pesan.

Mengembalikan nilai

Jenis: int

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

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 berpengaruh.

Jika tidak ada cukup memori untuk membuat kotak pesan, nilai yang dikembalikan adalah nol.

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 anggota lpszText dan lpszCaption dari struktur MSGBOXPARAMS 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 MessageBoxIndirect 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


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
Set API	ext-ms-win-ntuser-dialogbox-l1-1-0 (diperkenalkan di Windows 8)