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