IProgressDialog：：SetAnimation 方法 (shlobj_core.h)
[Windows Vista 或更新版本不支援此方法。]
指定在對話方塊中執行的 Audio-Video 交錯 (AVI) 剪輯。
語法
HRESULT SetAnimation(
[in, optional] HINSTANCE hInstAnimation,
UINT idAnimation
);
參數
[in, optional] hInstAnimation
類型： HINSTANCE
應該從中載入 AVI 資源的模組實例控制碼。
idAnimation
類型： UINT
AVI 資源識別碼。 若要建立此值，請使用 MAKEINTRESOURCE 宏。 控制項會從 hInstAnimation所指定的模組載入 AVI 資源。
傳回值
類型： HRESULT
如果成功，則傳回 S_OK ，否則傳回錯誤值。 在 Windows Vista 和更新版本中，一律會 傳回S_OK。
備註
在顯示進度對話方塊之前，無法呼叫IProgressDialog：：SetAnimation。 在顯示之前，進度對話方塊沒有有效的 HWND。 該 HWND 的存在可用來判斷是否可以呼叫 IProgressDialog：：SetAnimation 。
這個方法會採用 hInstAnimation 指定的實例控制碼，並使用 動畫控制項 來開啟和執行無訊息 AVI 剪輯。 您可以使用哪些類型的 AVI 剪輯有數個限制，包括下列各項：
- 剪輯不能包含音效。
- AVI 剪輯的大小不能超過 272 x 60 圖元。 您可以使用較小的矩形，但可能無法正確置中。
- AVI 剪輯必須解壓縮，或以執行時間長度壓縮 (BI_RLE8) 編碼。 如果您嘗試使用不支援的壓縮類型，則不會顯示任何動畫。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限桌面應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | shlobj_core.h |
| Dll | Shell32.dll (5.0 版或更新版本) |