CProgressCtrl 類別

發行項
03/15/2013

提供 Windows 通用進度列控制項的功能。

class CProgressCtrl : public CWnd

成員

公用建構函式

名稱	描述
CProgressCtrl::CProgressCtrl	建構 CProgressCtrl 物件。

公用方法

名稱	描述
CProgressCtrl::Create	建立進度列控制項並將其附加至 CProgressCtrl 物件。
CProgressCtrl::CreateEx	建立具有指定之視窗的延伸樣式之進度控制項並將其附加至 CProgressCtrl 物件。
CProgressCtrl::GetBarColor	取得進度列的色彩顯示目前進度列控制項。
CProgressCtrl::GetBkColor	取得目前進度列的背景色彩。
CProgressCtrl::GetPos	取得進度列的目前位置。
CProgressCtrl::GetRange	取得進度列控制項範圍的下限及上限。
CProgressCtrl::GetState	取得目前進度列控制項的狀態。
CProgressCtrl::GetStep	擷取目前進度列控制項的進度列的步驟加入。
CProgressCtrl::OffsetPos	將指定的加入前移進度列控制項中目前的位置及重繪該列來反映新的位置。
CProgressCtrl::SetBarColor	設定進度列顯示的色彩在目前進度列控制項。
CProgressCtrl::SetBkColor	設定進度列的背景色彩。
CProgressCtrl::SetMarquee	關閉跑馬燈模式切換目前進度列控制項。
CProgressCtrl::SetPos	設定進度列控制項中目前的位置及重繪該列來反映新的位置。
CProgressCtrl::SetRange	設定進度列控制項的最小和最大範圍和重繪該列來反映新的範圍。
CProgressCtrl::SetState	設定目前進度列控制項的狀態。
CProgressCtrl::SetStep	針對進度列控制項指定步驟加入。
CProgressCtrl::StepIt	藉由加入步驟前移進度列控制項的目前位置 (請參閱) SetStep和重繪該列來反映新的位置。

備註

進度列控制項是應用程式可以使用指示長時間作業的進度的視窗。它包括逐漸填滿，從左至右的矩形，與系統的醒目提示色彩，隨著作業的進度。

進度列控制項具有範圍和目前位置。這個範圍表示作業的總持續期間，，而且目前的位置表示應用程式在作業上已完成的進度。視窗程序會使用該範圍與目前位置判斷進度列的百分比以反白色彩填滿。由於範圍和目前位置值會表示為帶正負號的整數，表示目前的位置值的範圍是從 2,147,483,648 到 2,147,483,647 –包含。

如需使用 CProgressCtrl的資訊，請參閱控制項和使用 CProgressCtrl。