共用方式為

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 版或更新版本)

另請參閱

IProgressDialog