Metode IProgressDialog::SetAnimation (shlobj_core.h)
[Metode ini tidak didukung di Windows Vista atau versi yang lebih baru.]
Menentukan klip Audio-Video Interleaved (AVI) yang berjalan dalam kotak dialog.
Sintaks
HRESULT SetAnimation(
[in, optional] HINSTANCE hInstAnimation,
UINT idAnimation
);
Parameter
[in, optional] hInstAnimation
Jenis: HINSTANCE
Instans menangani modul tempat sumber daya AVI harus dimuat.
idAnimation
Jenis: UINT
Pengidentifikasi sumber daya AVI. Untuk membuat nilai ini, gunakan makro MAKEINTRESOURCE . Kontrol memuat sumber daya AVI dari modul yang ditentukan oleh hInstAnimation.
Nilai kembali
Jenis: HRESULT
Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya. Di Windows Vista dan versi yang lebih baru, selalu mengembalikan S_OK.
Keterangan
IProgressDialog::SetAnimation tidak dapat dipanggil sebelum dialog kemajuan terlihat. Hingga ditampilkan, dialog kemajuan tidak memiliki HWND yang valid. Keberadaan HWND tersebut dapat digunakan untuk menentukan apakah IProgressDialog::SetAnimation dapat dipanggil.
Metode ini mengambil handel instans yang ditentukan oleh hInstAnimation dan menggunakan kontrol animasi untuk membuka dan menjalankan klip AVI senyap. Ada beberapa batasan tentang jenis klip AVI apa yang dapat digunakan, termasuk yang berikut ini:
- Klip tidak dapat menyertakan suara.
- Ukuran klip AVI tidak boleh melebihi 272 kali 60 piksel. Persegi panjang yang lebih kecil dapat digunakan, tetapi mungkin tidak dipusatkan dengan benar.
- Klip AVI harus tidak dikompresi atau dikompresi dengan pengodean panjang eksekusi (BI_RLE8). Jika Anda mencoba menggunakan tipe kompresi yang tidak didukung, tidak ada animasi yang ditampilkan.
Persyaratan
| 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) |