Bagikan melalui

Metode IProgressDialog::SetAnimation (shlobj_core.h)

  • Artikel

[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)

Lihat juga

IProgressDialog