共用方式為


ProgressBar 控制項概觀 (Windows Form)

重要

ToolStripProgressBar 控制項會取代 ProgressBar 控制項並加入其他功能,不過您也可以選擇保留 ProgressBar 控制項,以提供回溯相容性及未來使用。

Windows Forms ProgressBar 控制項會藉由顯示以水平橫條排列的適當矩形數目,指出流程的進度。 當流程完成時,橫條就會填滿。 進度列通常用來讓使用者了解完成流程所需的時間;例如,載入大型檔案時。

注意

在表單上,ProgressBar 控制項只能是橫向的。

關鍵屬性和方法

ProgressBar 控制項的關鍵屬性為 ValueMinimumMaximumMinimumMaximum 屬性會設定進度列可以顯示的最大值和最小值。 Value 屬性代表作業完成過程中已達成的進度。 由於控制項中顯示的長條是由區塊所組成,因此 ProgressBar 控制項所顯示的值只會近似 Value 屬性目前的值。 根據 ProgressBar 控制項的大小,Value 屬性會決定何時顯示下一個區塊。

更新目前進度值最常見的方法是撰寫程式碼來設定 Value 屬性。 在載入大型檔案的範例中,您可以使用 KB 為單位,來設定檔案的大小上限。 例如,如果 Maximum 屬性設定為 100、Minimum 屬性設定為 10,而 Value 屬性設定為 50,則會顯示 5 個矩形。 這是可顯示數字的一半。

不過,除了直接設定 Value 屬性之外,還有其他方法可以修改 ProgressBar 控制項所顯示的值。 Step 屬性可用來指定遞增 Value 屬性的值。 然後,呼叫 PerformStep 方法會遞增值。 若要改變遞增值,您可以使用 Increment 方法,並指定用來遞增 Value 屬性的值。

另一個以圖形方式通知使用者目前動作的控制項是 StatusBar 控制項。

重要

StatusStripToolStripStatusLabel 控制項會取代和新增 StatusBarStatusBarPanel 控制項的功能;不過,您可以選擇保留 StatusBarStatusBarPanel 控制項,以提供回溯相容性及方便日後使用。

另請參閱