Metode IProgressDialog::SetCancelMsg (shlobj_core.h)
Mengatur pesan yang akan ditampilkan jika pengguna membatalkan operasi.
Sintaks
HRESULT SetCancelMsg(
[in] PCWSTR pwzCancelMsg,
LPCVOID pvResevered
);
Parameter
[in] pwzCancelMsg
Jenis: PCWSTR
Penunjuk ke string Unicode yang dihentikan null yang berisi pesan yang akan ditampilkan.
pvResevered
Jenis: LPCVOID
Dicadangkan. Atur ke NULL.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Meskipun pengguna mengklik Batal, aplikasi tidak dapat segera memanggil IProgressDialog::StopProgressDialog untuk menutup kotak dialog. Aplikasi harus menunggu hingga kali berikutnya memanggil IProgressDialog::HasUserCancelled untuk menemukan bahwa pengguna telah membatalkan operasi. Karena penundaan ini mungkin signifikan, kotak dialog kemajuan memberi pengguna umpan balik langsung dengan menghapus baris teks 1 dan 2 dan menampilkan pesan pembatalan pada baris 3. Pesan ini dimaksudkan untuk memberi tahu pengguna bahwa penundaan normal dan bahwa kotak dialog kemajuan akan segera ditutup. Biasanya diatur ke sesuatu seperti "Silakan tunggu sementara ...".
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlobj_core.h |
| DLL | Shell32.dll (versi 5.0 atau yang lebih baru) |