ProgressBar 控件概述(Windows 窗体)

重要

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

Windows 窗体 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 控件以实现向后兼容性和将来使用。

另请参阅