Fungsi ShellMessageBoxW (shellapi.h)

Artikel
03/15/2023

[ShellMessageBox tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

ShellMessageBox adalah instans khusus MessageBox yang menyediakan opsi untuk menggunakan judul jendela pemilik sebagai judul kotak pesan.

Sintaks

int ShellMessageBoxW(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCWSTR   lpcText,
  [in] LPCWSTR   lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

Parameter

[in] hAppInst

Jenis: HINSTANCE

Handel modul tempat memuat sumber daya string bernama dalam pszTitle. Jika pszTitle tidak memberi nama sumber daya string, parameter ini diabaikan. Nilai ini harus valid jika pszMsg atau pszTitle adalah ID sumber daya.

[in] hWnd

Jenis: HWND

Handel ke jendela pemilik kotak pesan yang akan dibuat. Jika variabel ini bukan NULL, judul jendela pemilik digunakan sebagai judul kotak pesan.

[in] lpcText

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi pesan yang akan ditampilkan atau ID sumber daya yang menentukan dari mana pesan akan diambil.

[in] lpcTitle

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi judul kotak dialog atau ID sumber daya yang menentukan tempat judul akan diambil. Jika parameter ini dan hWndNULL, tidak ada judul yang ditampilkan. Jika parameter ini menunjuk ke sumber daya yang dapat dimuat yang dibentuk dengan makro MAKEINTRESOURCE , parameter ini akan menggantikan hWnd sebagai judul.

[in] fuStyle

Jenis: UINT

Menentukan isi dan perilaku kotak dialog. Untuk nilai yang mungkin, lihat MessageBox.

...

Daftar argumen variabel yang dikombinasikan dengan pszMsg untuk membentuk teks lengkap yang ditampilkan dalam kotak pesan.

Mengembalikan nilai

Jenis: int

Nilai bilangan bulat yang menunjukkan tombol yang ditekan di kotak pesan. Untuk nilai tertentu, lihat MessageBox.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Catatan

Header shellapi.h mendefinisikan ShellMessageBox sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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 XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shellapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll

Lihat juga

MAKEINTRESOURCE

Kotak Pesan

Bagikan melalui