syncfusion-maui-toolkit-circular-progressbar

在 .NET MAUI 中实现圆形进度条

Syncfusion .NET MAUI 圆形进度条（SfCircularProgressBar）以圆形方式显示进度，并提供丰富的自定义选项。它支持确定和不确定状态、平滑动画、分段进度、渐变颜色、自定义角度和中心内容。非常适用于任务完成情况、加载指示器、仪表板和进度跟踪。

何时使用此技能

当用户需要以下功能时，请使用此技能：

• 显示圆形进度指示器，用于任务、下载、上传或操作
• 实现确定进度，显示已知的完成百分比（0-100%）
• 显示不确定进度，适用于时长未知的情况（加载、处理）
• 创建分段进度，用于多步骤工作流或顺序任务
• 自定义外观，包括角度、颜色、渐变、粗细或边角样式
• 添加动画，使用缓动效果实现平滑的进度过渡
• 显示自定义内容，位于中心位置（文本、图标、按钮、图像）
• 处理进度事件，以响应值变化或完成事件
• 构建半圆或弧形进度指示器，并自定义角度
• 可视化进度范围，使用多种颜色表示不同状态

组件概述

SfCircularProgressBar 控件提供：

• 灵活的状态： 确定状态（已知进度）和不确定状态（时长未知）
• 视觉自定义： 角度、粗细、颜色、渐变、边角样式
• 分段： 将进度拆分为多个片段，并配置间隙
• 动画支持： 使用可自定义的时长和缓动效果实现平滑过渡
• 范围配置： 自定义最小值/最大值（默认值为 0-100）
• 中心内容： 在中心添加任意 MAUI 视图（文本、按钮、图像）
• 事件： ProgressChanged 和 ProgressCompleted，用于交互
• 丰富的渐变支持： 多个颜色范围，可使用纯色或渐变过渡

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装和 NuGet 包设置
• 在 MauiProgram.cs 中注册 Syncfusion 处理程序
• 基本圆形进度条实现（XAML 和 C#）
• 第一个可运行示例

状态和进度模式

📄 阅读： references/states.md

• 确定状态（默认，用于已知进度）
• 不确定状态（用于时长未知的情况）
• 各状态的适用场景
• 组合确定和不确定模式

分段

📄 阅读： references/segments.md

• 可视化多个顺序任务
• 使用 SegmentCount 属性拆分进度
• 自定义片段之间的间隙
• 分段进度的使用场景

外观自定义

📄 阅读： references/appearance.md

• 自定义角度（StartAngle、EndAngle），创建半圆和弧形
• 使用 GradientStops 设置范围颜色（纯色和渐变）
• 配置粗细和半径（Pixel 与 Factor）
• 自定义边角样式（平直、弧形）
• 自定义进度和轨道颜色

动画

📄 阅读： references/animation.md

• 确定和不确定状态的动画时长
• 缓动效果（Linear、CubicInOut、BounceIn 等）
• 使用带有自定义动画的 SetProgress() 方法
• 控制动画速度和行为

范围配置

📄 阅读： references/range.md

• 定义自定义进度范围
• Minimum 和 Maximum 属性
• 使用因子值（0-1）或百分比（0-100）

自定义内容

📄 阅读： references/custom-content.md

• 在中心添加视图（Content 属性）
• 使用数据绑定的自定义文本
• 用于控制进度的按钮
• 作为指示器的图像和图标
• 布局示例

事件

📄 阅读： references/events.md

• 值变化时触发 ProgressChanged 事件
• 完成时触发 ProgressCompleted 事件
• 处理事件参数
• 根据进度动态调整行为