Struktur MSGBOXPARAMSW (winuser.h)

Berisi informasi yang digunakan untuk menampilkan kotak pesan. Fungsi MessageBoxIndirect menggunakan struktur ini.

Sintaksis

typedef struct tagMSGBOXPARAMSW {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCWSTR        lpszText;
  LPCWSTR        lpszCaption;
  DWORD          dwStyle;
  LPCWSTR        lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSW, *PMSGBOXPARAMSW, *LPMSGBOXPARAMSW;

Anggota

cbSize

Jenis: UINT

Ukuran struktur, dalam byte.

hwndOwner

Jenis: HWND

Handel ke jendela pemilik. Anggota ini dapat null.

hInstance

Jenis: HINSTANCE

Handel ke modul yang berisi sumber daya ikon yang diidentifikasi oleh anggota lpszIcon, dan sumber daya string yang diidentifikasi oleh lpszText atau anggota lpszCaption .

lpszText

Jenis: LPCTSTR

String yang dihentikan null, atau pengidentifikasi sumber daya string, yang berisi pesan yang akan ditampilkan.

lpszCaption

Jenis: LPCTSTR

String yang dihentikan null, atau pengidentifikasi sumber daya string, yang berisi judul kotak pesan. Jika anggota ini null, judul default Kesalahan digunakan.

dwStyle

Jenis: DWORD

Konten dan perilaku kotak dialog. Anggota ini dapat menjadi kombinasi bendera yang dijelaskan untuk parameter uType dari fungsi MessageBoxEx.

Selain itu, Anda dapat menentukan bendera MB_USERICON (0x00000080L) jika Anda ingin kotak pesan menampilkan ikon yang ditentukan oleh lpszIcon anggota.

lpszIcon

Jenis: LPCTSTR

Mengidentifikasi sumber daya ikon. Parameter ini dapat berupa string yang dihentikan null atau pengidentifikasi sumber daya bilangan bulat yang diteruskan ke makro MAKEINTRESOURCE.

Untuk memuat salah satu ikon standar yang ditentukan sistem, atur anggota hInstance ke NULL dan atur lpszIcon ke salah satu nilai yang tercantum dengan fungsi LoadIcon .

Anggota ini diabaikan jika anggota dwStyle tidak menentukan bendera MB_USERICON.

dwContextHelpId

Jenis: DWORD_PTR

Mengidentifikasi konteks bantuan. Jika peristiwa bantuan terjadi, nilai ini ditentukan dalam struktur HELPINFO yang dikirim kotak pesan ke jendela pemilik atau fungsi panggilan balik.

lpfnMsgBoxCallback

Jenis: MSGBOXCALLBACK

Penunjuk ke fungsi panggilan balik yang memproses peristiwa bantuan untuk kotak pesan. Fungsi panggilan balik memiliki formulir berikut:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Jika anggota ini NULL, maka kotak pesan mengirim pesan WM_HELP ke jendela pemilik saat peristiwa bantuan terjadi.

dwLanguageId

Jenis: DWORD

Bahasa untuk menampilkan teks yang terkandung dalam tombol tekan yang telah ditentukan sebelumnya. Nilai ini harus dalam formulir yang dikembalikan oleh makro MAKELANGID.

Untuk daftar pengidentifikasi bahasa yang didukung, lihat Pengidentifikasi Bahasa . Perhatikan bahwa setiap rilis Windows yang dilokalkan biasanya hanya berisi sumber daya untuk sekumpulan bahasa terbatas. Jadi, misalnya, versi A.S. menawarkan LANG_ENGLISH, versi Prancis menawarkan LANG_FRENCH, versi Jerman menawarkan LANG_GERMAN, dan versi Jepang menawarkan LANG_JAPANESE. Setiap versi menawarkan LANG_NEUTRAL. Ini membatasi kumpulan nilai yang dapat digunakan dengan parameter dwLanguageId. Sebelum menentukan pengidentifikasi bahasa, Anda harus menghitung lokal yang diinstal pada sistem.

Komentar

Nota

Header winuser.h mendefinisikan MSGBOXPARAMS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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]
Header	winuser.h (termasuk Windows.h)

Lihat juga

Konseptual

Kotak Dialog

HELPINFO

LoadIcon

MAKEINTRESOURCE

MAKELANGID

MessageBoxEx

MessageBoxIndirect

Sumber Daya Lain

Referensi

WM_HELP