Fungsi ShellAboutA (shellapi.h)

Menampilkan ShellTentang kotak dialog.

Sintaksis

INT ShellAboutA(
  [in, optional] HWND   hWnd,
  [in]           LPCSTR szApp,
  [in, optional] LPCSTR szOtherStuff,
  [in, optional] HICON  hIcon
);

Parameter

[in, optional] hWnd

Jenis: HWND

Handel jendela ke jendela induk. Parameter ini dapat null.

[in] szApp

Jenis: LPCTSTR

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: LPCTSTR

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.

Persyaratan