ProgressBar 控件概述(Windows 窗体)

重要

ToolStripProgressBar 控件取代了 ProgressBar 控件并添加了功能;但是,可以选择保留 ProgressBar 控件以实现向后兼容并供将来使用。

Windows 窗体 ProgressBar 控件通过在水平条中显示适当数量的矩形来指示流程的进度。 流程完成时,该水平条被填满。 进度条通常用于让用户了解等待流程完成的时间;例如,当加载一个大文件时。

注意

ProgressBar 控件只能位于窗体上的水平定向。

关键属性和方法

ProgressBar 控件的关键属性包括 ValueMinimumMaximumMinimumMaximum 属性设置进度条可以显示的最大值和最小值。 Value 属性表示已完成操作的进度。 因为控件中显示的条由块组成,所以 ProgressBar 控件显示的值只是近似于 Value 属性的当前值。 Value 属性根据 ProgressBar 控件的大小,确定何时显示下一个块。

更新当前进度值的最常用方法是编写代码来设置 Value 属性。 在加载大文件的示例中,可以将最大值设置为以 KB 为单位的文件大小。 例如,如果 Maximum 属性设置为 100,Minimum 属性设置为 10,Value 属性设置为 50,则将显示 5 个矩形。 这是可以显示的数字的一半。

但是,除了直接设置 Value 属性外,还可通过其他方法修改 ProgressBar 控件显示的值。 Step 属性可用于指定 Value 属性的递增值。 然后,调用 PerformStep 方法可递增该值。 要改变增量值,可以使用 Increment 方法并指定 Value 属性的递增值。

另一个以图形方式通知用户当前操作的控件是 StatusBar 控件。

重要

StatusStripToolStripStatusLabel 控件取代了 StatusBarStatusBarPanel 控件并向其中添加了新功能;但也可选择保留 StatusBarStatusBarPanel 控件以备后向兼容和供将来使用。

另请参阅