Antarmuka IActionProgress (shobjidl_core.h)
Mewakili kelas dasar abstrak dari mana operasi berbasis kemajuan dapat mewarisi.
Warisan
Antarmuka IActionProgress mewarisi dari antarmuka IUnknown . IActionProgress juga memiliki jenis anggota ini:
Metode
Antarmuka IActionProgress memiliki metode ini.
|
IActionProgress::Begin Dipanggil ketika tindakan telah dimulai yang mengharuskan kemajuannya ditampilkan kepada pengguna. |
|
IActionProgress::End Menunjukkan bahwa tindakan yang terkait dengan implementasi kemajuan ini telah berakhir. |
|
IActionProgress::QueryCancel Menyediakan informasi tentang apakah tindakan dibatalkan. |
|
IActionProgress::ResetCancel Mereset dialog kemajuan setelah pembatalan selesai. |
|
IActionProgress::UpdateProgress Updates kemajuan tindakan ke UI. |
|
IActionProgress::UpdateText Dipanggil jika teks deskriptif yang terkait dengan tindakan akan diubah. |
Keterangan
Kelas ini adalah kelas abstrak yang mungkin tidak dibuat. Ini menyediakan kerangka kerja yang dapat digunakan kelas turunan untuk mengimplementasikan panggilan balik kemajuan. Panggilan balik ini dapat digunakan oleh aplikasi untuk melaporkan kemajuan tindakan ke UI. Di sini, "Tindakan" mengacu pada operasi yang mungkin memakan waktu yang signifikan, seperti mengunduh atau menyalin file, dan selama indikasi kemajuan yang terlihat akan sesuai.
Aplikasi biasanya tidak mengimplementasikan antarmuka ini. Sebagian besar fungsi yang berinteraksi dengan pengguna selama tindakan disediakan oleh kelas CProgressDialog (CLSID_ProgressDialog) yang mengimplementasikan IActionProgress dan menampilkan kemajuan dalam kotak dialog. Jika solusi yang memerlukan mekanisme selain kotak dialog diperlukan, IActionProgress dapat digunakan untuk menyediakan fungsionalitas indikator kemajuan dasar.
Setelah diimplementasikan, kelas harus memanggil IActionProgress::Mulailah saat tindakan dimulai. Secara berkala, IActionProgress::UpdateProgress harus dipanggil untuk memperbarui UI dengan informasi kemajuan, dan informasi tekstual terperinci harus disampaikan ke UI dengan memanggil IActionProgress::UpdateText. IActionProgress::QueryCancel dan IActionProgress::ResetCancel harus dipanggil untuk menangani permintaan pembatalan. Setelah operasi berakhir, IActionProgress::End harus dipanggil.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shobjidl_core.h (termasuk Shobjidl.h) |