Fungsi ShellAboutW (shellapi.h)
Menampilkan ShellTentang kotak dialog.
Sintaksis
INT ShellAboutW(
[in, optional] HWND hWnd,
[in] LPCWSTR szApp,
[in, optional] LPCWSTR szOtherStuff,
[in, optional] HICON hIcon
);
Parameter
[in, optional] hWnd
Jenis: HWND
Handel jendela ke jendela induk. Parameter ini dapat null.
[in] szApp
Jenis:
Penunjuk ke string null-terminated yang berisi teks yang akan ditampilkan di bilah judul kotak dialog ShellAbout dan pada baris pertama kotak dialog setelah teks "Microsoft". Jika teks berisi pemisah (#) yang membaginya menjadi dua bagian, fungsi menampilkan bagian pertama di bilah judul dan bagian kedua pada baris pertama setelah teks "Microsoft".
Windows 2000, Windows XP, Windows Server 2003: Jika string yang diacu oleh parameter ini berisi pemisah (#), maka string harus dapat ditulis.
Windows Vista, Windows Server 2008: Panjang string ini tidak boleh melebihi 200 karakter. Konten szApp tidak akan lagi ditampilkan setelah "Microsoft", kecuali ada pemisah #, dalam hal ini bagian setelah # akan sepenuhnya menggantikan baris pertama.
[in, optional] szOtherStuff
Jenis:
Penunjuk ke string null-terminated yang berisi teks yang akan ditampilkan dalam kotak dialog setelah informasi versi dan hak cipta. Parameter ini dapat null.
[in, optional] hIcon
Jenis: HICON
Gagang ikon yang ditampilkan fungsi dalam kotak dialog. Parameter ini dapat NULL, dalam hal ini fungsi menampilkan ikon Windows.
Mengembalikan nilai
Jenis: int
TRUE jika berhasil; jika tidak, FALSE.
Komentar
Perhatikan bahwa kotak dialog ShellTentang fungsi menggunakan teks dan ikon default yang khusus untuk Windows.
Untuk melihat contoh kotak dialog ShellTentang, jalankan perintah winver.exe
.
Nota
Header shellapi.h mendefinisikan ShellAbout 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 XP [hanya aplikasi desktop] |
server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Platform Target |
Windows |
Header |
shellapi.h |
Pustaka |
Shell32.lib |
DLL |
Shell32.dll (versi 3.51 atau yang lebih baru) |
set API |
ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan di Windows 10, versi 10.0.14393) |