syncfusion-maui-circular-progressbar

实现 .NET MAUI 圆形进度条

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

何时使用此技能

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

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

组件概述

SfCircularProgressBar 控件提供：

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

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装和 NuGet 包设置
• 在 MauiProgram.cs 中注册处理程序
• 基本圆形进度条实现（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 事件
• 处理事件参数
• 根据进度动态调整行为