跳到主要内容

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 根据 Value、 Minimum 和 Maximum 显示完成百分比。 这个文本的格式可以通过使用 ProgressTextFormat 属性来自定义。这需要一个字符串，将传递给 string.Format 调用， 其中 ProgressTextFormat 作为格式字符串。以下格式项在给定的索引处可用：

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

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

更多信息​

信息

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

信息

在 GitHub 上查看源代码 ProgressBar.cs