Metode IProgressDialog::StartProgressDialog (shlobj_core.h)
Memulai kotak dialog kemajuan.
Sintaks
HRESULT StartProgressDialog(
[in] HWND hwndParent,
IUnknown *punkEnableModless,
DWORD dwFlags,
LPCVOID pvResevered
);
Parameter
[in] hwndParent
Jenis: HWND
Handel ke jendela induk kotak dialog.
punkEnableModless
Jenis: IUnknown*
Dicadangkan. Atur ke NULL.
dwFlags
Jenis: DWORD
Bendera yang mengontrol operasi kotak dialog kemajuan. Kombinasi nilai berikut:
PROGDLG_NORMAL
Perilaku kotak dialog kemajuan normal.
PROGDLG_MODAL
Kotak dialog kemajuan akan diubah ke jendela yang ditentukan oleh hwndParent. Secara default, kotak dialog kemajuan tidak memiliki mode.
PROGDLG_AUTOTIME
Perkirakan waktu yang tersisa secara otomatis dan tampilkan perkiraan pada baris 3. Jika bendera ini diatur, IProgressDialog::SetLine hanya dapat digunakan untuk menampilkan teks pada baris 1 dan 2.
PROGDLG_NOTIME
Jangan tampilkan teks "waktu tersisa".
PROGDLG_NOMINIMIZE
Jangan tampilkan tombol minimalkan pada bilah caption kotak dialog.
PROGDLG_NOPROGRESSBAR
Jangan tampilkan bilah kemajuan. Biasanya, aplikasi dapat secara kuantitatif menentukan berapa banyak operasi yang tersisa dan secara berkala meneruskan nilai tersebut ke IProgressDialog::SetProgress. Kotak dialog kemajuan menggunakan informasi ini untuk memperbarui bilah kemajuannya. Bendera ini biasanya diatur ketika aplikasi panggilan harus menunggu operasi selesai, tetapi tidak memiliki informasi kuantitatif apa pun yang dapat digunakan untuk memperbarui kotak dialog.
PROGDLG_MARQUEEPROGRESS
Windows Vista dan yang lebih baru. Mengatur bilah kemajuan ke mode marquee. Ini menyebabkan bilah kemajuan digulir secara horizontal, mirip dengan tampilan marquee. Gunakan ini ketika Anda ingin menunjukkan bahwa kemajuan sedang dibuat, tetapi waktu yang diperlukan untuk operasi tidak diketahui.
PROGDLG_NOCANCEL
Windows Vista dan yang lebih baru. Jangan tampilkan tombol batalkan. Operasi tidak dapat dibatalkan. Gunakan ini hanya jika benar-benar diperlukan.
pvResevered
Jenis: LPCVOID
Dicadangkan. Atur ke NULL.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
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) |