共用方式為


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::QueryCancelIActionProgress::ResetCancel 來處理取消要求。 作業結束時,應該呼叫 IActionProgress::End

規格需求

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

另請參閱

IProgressDialog