Bagikan melalui


Fungsi MessageBoxIndirectA (winuser.h)

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

Sintaksis

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 batalkan , fungsi mengembalikan nilai IDCANCEL jika tombol ESC ditekan atau tombol Batalkan dipilih. Jika kotak pesan tidak memiliki tombol Batalkan, 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 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

Ketika Anda menggunakan kotak pesan modal sistem untuk menunjukkan bahwa sistem kekurangan memori, string yang ditunjukkan oleh lpszText dan lpszCaption anggota 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.

Nota

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

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

Lihat juga

Konseptual

Kotak Dialog

MSGBOXPARAMS

Kotak Pesan

MessageBoxEx

Referensi