ProgressBar 控件概述(Windows 窗体)

重要

ToolStripProgressBar 控件替换并添加 ProgressBar 控件的功能;但是,如果选择,则保留 ProgressBar 控件以实现后向兼容性和将来使用。

Windows 窗体 ProgressBar 控件通过显示水平条中排列的相应矩形数来指示进程的进度。 当过程完成后,进度条会被填满。 进度栏通常用于让用户了解等待进程完成的时间:例如,加载大型文件时。

注释

控件 ProgressBar 在窗体上只能水平定位。

主要属性和方法

控件的关键 ProgressBar 属性是 ValueMinimum以及 MaximumMaximumMinimum属性设置进度栏可以显示的最大值和最小值。 该 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 控件以实现向后兼容性和将来使用。

另请参阅