Metode IOperationsProgressDialog::StartProgressDialog (shobjidl_core.h)

Memulai dialog kemajuan yang ditentukan.

Sintaks

HRESULT StartProgressDialog(
  [in] HWND       hwndOwner,
  [in] OPPROGDLGF flags
);

Parameter

[in] hwndOwner

Jenis: HWND

Handel ke jendela induk.

[in] flags

Jenis: DWORD

Bendera yang menyesuaikan operasi. Perhatikan bahwa bendera ini dideklarasikan dalam Shlobj.h. Kombinasi nilai berikut:

PROGDLG_NORMAL (0x00000000)

Perilaku dialog kemajuan normal default.

PROGDLG_MODAL (0x00000001)

Dialog dimodifikasi ke hwndOwner-nya. Pengaturan default tidak mode.

PROGDLG_AUTOTIME (0x00000002)

Perbarui teks "Line3" dengan waktu yang tersisa. Bendera ini tidak perlu diatur secara implisit karena dialog kemajuan yang dimulai oleh IOperationsProgressDialog::StartProgressDialog secara otomatis menampilkan waktu yang tersisa.

PROGDLG_NOTIME (0x00000004)

Jangan perlihatkan sisa waktu. Kami tidak menyarankan pengaturan bendera ini melalui IOperationsProgressDialog karena bertentangan dengan tujuan dialog.

PROGDLG_NOMINIMIZE (0x00000008)

Jangan tampilkan tombol minimalkan.

PROGDLG_NOPROGRESSBAR (0x00000010)

Jangan tampilkan bilah kemajuan.

PROGDLG_MARQUEEPROGRESS (0x00000020)

Bendera ini tidak valid dalam metode ini. Untuk mengatur bilah kemajuan ke mode marquee, gunakan bendera di IOperationsProgressDialog::SetMode.

PROGDLG_NOCANCEL (0x00000040)

Jangan tampilkan tombol batal karena operasi tidak dapat dibatalkan. Gunakan nilai ini hanya jika benar-benar diperlukan.

OPPROGDLG_DEFAULT (0x00000000)

Windows 7 dan yang lebih baru. Menunjukkan perilaku dialog kemajuan operasi normal default.

OPPROGDLG_ENABLEPAUSE (0x00000080)

Tampilkan tombol jeda. Gunakan ini hanya dalam situasi di mana operasi dapat dijeda.

OPPROGDLG_ALLOWUNDO (0x00000100)

Operasi dapat dibatalkan melalui dialog. Tombol Hentikan menjadi Batalkan. Jika ditekan, tombol Batalkan lalu kembali ke Berhenti.

OPPROGDLG_DONTDISPLAYSOURCEPATH (0x00000200)

Jangan tampilkan jalur file sumber dalam dialog kemajuan.

OPPROGDLG_DONTDISPLAYDESTPATH (0x00000400)

Jangan tampilkan jalur file tujuan dalam dialog kemajuan.

OPPROGDLG_NOMULTIDAYESTIMATES (0x00000800)

Windows 7 dan yang lebih baru. Jika perkiraan waktu penyelesaian lebih besar dari satu hari, jangan tampilkan waktu.

OPPROGDLG_DONTDISPLAYLOCATIONS (0x00001000)

Windows 7 dan yang lebih baru. Jangan tampilkan baris lokasi dalam dialog kemajuan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Dialog kemajuan harus dibuat pada utas terpisah dari operasi file tempat dialog dilaporkan. Jika dialog berjalan dalam utas yang sama dengan operasi file, pesan kemajuan, paling baik, hanya dikirim sebagai sumber daya yang diizinkan. Pesan kemajuan pada utas yang sama dengan operasi file mungkin tidak dikirim sama sekali.

Setelah IOperationsProgressDialog::StartProgressDialog dipanggil, instans objek CLSID_ProgressDialog tersebut tidak dapat diakses oleh IProgressDialog, IActionProgressDialog, atau IActionProgress. Meskipun QueryInterface dapat digunakan untuk mengakses antarmuka ini, sebagian besar metodenya tidak dapat dipanggil. IOperationsProgressDialog adalah antarmuka yang digunakan untuk menampilkan dialog kemajuan baru untuk Windows Vista dan mesin operasi yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)