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)

Lihat juga

IProgressDialog