Fungsi ShellMessageBoxA (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 ShellMessageBoxA(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCSTR    lpcText,
  [in] LPCSTR    lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

Parameter

[in] hAppInst

Jenis: HINSTANCE

Handel modul tempat memuat sumber daya string bernama di 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 hWndadalah NULL, 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.

Menampilkan 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 praproscesor 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 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