用途:在 WPF 中实现 SfLinearProgressBar 线性进度指示控件,适用于显示已知进度的确定进度条、进度未知时的不确定弹跳动画、主进度与缓冲(次要)进度同时显示、分段进度,以及颜色、渐变、内边距和圆角等外观自定义,并可按进度值区间应用范围颜色。
程序集:Syncfusion.SfProgressBar.WPF;命名空间:Syncfusion.UI.Xaml.ProgressBar;XAML Schema:http://schemas.syncfusion.com/wpf;关键类:SfLinearProgressBar。
快速开始(XAML):在 Window 上声明 xmlns:Syncfusion="http://schemas.syncfusion.com/wpf",在 Grid 内放置 Syncfusion:SfLinearProgressBar,设置 Progress="70"、Width="500"、Height="20"。C# 方式:using Syncfusion.UI.Xaml.ProgressBar; 创建 SfLinearProgressBar 实例,设置 Progress = 70、Width = 500、Height = 20,再加入 grid.Children。
状态:确定状态(默认)用于已知进度;不确定状态用 IsIndeterminate="True";缓冲状态使用 SecondaryProgress 与 SecondaryProgressColor。可通过 MVVM 绑定动态切换状态。
外观与分段:IndicatorCornerRadius 设置圆角端点;IndicatorPadding 设置轨道与进度条之间的间距;ProgressColor 与 TrackColor 自定义颜色;RangeColors 使用 RangeColor 的 Start、End、Color 设定范围颜色,RangeColor.IsGradient 启用渐变;AnimationDuration 与 AnimationEasing 仅用于不确定状态;SegmentCount 将进度条分为若干段,分段同样支持圆角。
关键属性:Progress(double,默认 0,0–100 的当前进度值)、IsIndeterminate(bool,默认 false)、SecondaryProgress(double,默认 0,缓冲/次要进度值)、SecondaryProgressColor(Brush,主题默认)、ProgressColor(Brush,主题默认)、TrackColor(Brush,主题默认)、IndicatorCornerRadius(double,默认 0)、IndicatorPadding(Thickness,默认 0)、SegmentCount(int,默认 0,即不分段)、AnimationDuration(TimeSpan,默认 3000ms)。
常见用例:文件下载进度条绑定下载百分比;加载动画使用不确定状态;视频缓冲用 SecondaryProgress 领先于 Progress;步骤跟踪器用 SegmentCount 对应总步数;健康/电池条用 RangeColors 映射绿黄红区间;圆角进度条使用 IndicatorCornerRadius="10"。
安装方式、NuGet 包、主题集成与详细文档路径见参考资料:入门 references/getting-started.md(含 NuGet/程序集安装、XAML 命名空间与 schema 声明、XAML 与代码后置声明、设置 Progress、通过 SfSkinManager 集成主题)、状态 references/states.md、外观与分段 references/appearance-and-segments.md。其他平台、价格或授权信息暂未提供。