IActionProgress 介面 (shobjidl_core.h)

  • 發行項

表示進度驅動作業可以繼承的抽象基類。

繼承

IActionProgress 介面繼承自 IUnknown 介面。 IActionProgress 也有下列類型的成員：

方法

IActionProgress 介面具有這些方法。

 
IActionProgress：：Begin

當動作開始需要向用戶顯示其進度時呼叫。
IActionProgress：：End

表示與此進度實作相關聯的動作已結束。
IActionProgress：：QueryCancel

提供是否取消動作的相關信息。
IActionProgress：：ResetCancel

完成取消之後，重設進度對話框。
IActionProgress：：UpdateProgress

匯報 UI 動作的進度。
IActionProgress：：UpdateText

如果與動作相關聯的描述性文字將會變更，則呼叫 。

備註

這個類別是一個抽象類，可能不會具現化。 它提供衍生類別可用來實作進度回呼的架構。 應用程式可以使用此回呼來向UI報告動作進度。 在這裡，「動作」是指可能需要大量時間的作業，例如下載或複製檔案，以及適當的可見進度指示。

應用程式通常不會實作此介面。 用戶在動作期間互動的大部分功能是由 CProgressDialog 類別所提供， (CLSID_ProgressDialog) 實作 IActionProgress 並在對話框中顯示進度。 如果需要對話方塊以外的機制的解決方案， 可以使用 IActionProgress 來提供基本進度指標功能。

實作之後，類別應該會在動作啟動時呼叫 IActionProgress：：Begin 。 應該定期呼叫 IActionProgress：：UpdateProgress ，以進度資訊更新 UI，而詳細的文字資訊應該藉由呼叫 IActionProgress：：UpdateText 來傳達給 UI。 應該呼叫 IActionProgress：：QueryCancel 和 IActionProgress：：ResetCancel 來處理取消要求。 作業結束時，應該呼叫 IActionProgress：：End 。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)

另請參閱

IProgressDialog