跳到主要内容
版本:11.0.0

ProgressBar 进度条

ProgressBar 以比例填充的条形显示一个值,并提供显示标题的选项。

常用属性

你可能最常使用这些属性:

属性描述
Minimum最小值。
Maximum最大值。
Value当前值。
Foreground进度条颜色。
ShowProgressText进度条显示进度文本标题。
ProgressTextFormat应用于进度文本的格式字符串。

示例

<StackPanel Margin="20">
<ProgressBar Margin="0 10" Height="20"
Minimum="0" Maximum="100" Value="14"
ShowProgressText="True"/>
<ProgressBar Margin="0 10" Height="20"
Minimum="0" Maximum="100" Value="92"
Foreground="Red"
ShowProgressText="True"/>
</StackPanel>

ProgressTextFormat 示例

默认情况下,ShowProgressText 根据 ValueMinimumMaximum 显示完成百分比。 这个文本的格式可以通过使用 ProgressTextFormat 属性来自定义。这需要一个字符串,将传递给 string.Format 调用, 其中 ProgressTextFormat 作为格式字符串。以下格式项在给定的索引处可用:

  • 0 = Value
  • 1 = Value 作为从 0 到 100 的百分比(例如,Minimum = 0Maximum = 50Value = 25,则 Percentage = 50
  • 2 = Minimum
  • 3 = Maximum
最小值最大值ProgressTextFormat输出
02017{}{0}/{3} 任务完成 ({1:0}%)17/20 任务完成 (85%)

由于 {0} 在此示例中出现在字符串的开头,因此必须对其进行转义。

更多信息

信息

要查看关于此控件的完整 API 文档,请查看这里

信息

GitHub 上查看源代码 ProgressBar.cs