syncfusion-maui-toolkit-pyramid-charts

实现 .NET MAUI 金字塔图表

指导用户实现 Syncfusion .NET MAUI 金字塔图表（SfPyramidChart）。该图表通过层级分段展示整体中的各部分比例，非常适合在高质量的 .NET MAUI 应用中展示部分与整体的关系。作为不带坐标轴的单系列图表，它以百分比表示数据，其中各部分之和等于整体。

何时使用此技能

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

• 创建金字塔图表，以在 .NET MAUI 应用中展示层级或比例数据
• 展示部分与整体的关系，其中各分段表示整体中的百分比
• 实现漏斗式可视化，用于展示销售阶段、流程或人口统计细分
• 为金字塔图表添加交互功能，例如工具提示、图例和数据标签
• 自定义外观，包括调色板、渐变和分段间距
• 将图表可视化内容导出为图像（JPEG/PNG）或流，用于报告和文档
• 配置数据绑定，将视图模型绑定到金字塔图表分段

组件概览

SfPyramidChart 控件提供：

• 单系列层级数据可视化
• 可自定义的交互式工具提示和图例
• 丰富的数据标签位置选项（Auto、Inner、Center、Outer）
• 自定义调色板画笔和渐变支持
• 两种金字塔模式：Linear（基于高度）和 Surface（基于面积）
• 使用 GapRatio 控制分段间距
• 导出为图像格式或流
• 通过与图例交互切换系列的可见性
• 可滚动图例，便于处理溢出内容

文档和导航指南

入门

📄 阅读： references/getting-started.md

当用户需要以下操作时：

• 安装 Syncfusion.Maui.Toolkit NuGet 包
• 在 XAML 或 C# 中初始化 SfPyramidChart
• 创建视图模型并将数据绑定到图表
• 配置 ItemsSource、XBindingPath 和 YBindingPath
• 了解金字塔图表的基本设置和命名空间导入
• 查看包含数据绑定的完整可运行示例

数据标签

📄 阅读： references/data-labels.md

当用户需要以下操作时：

• 启用并显示金字塔分段上的数据标签
• 配置 PyramidDataLabelSettings 以自定义标签
• 控制标签位置（Auto、Inner、Center、Outer）
• 设置标签上下文，以显示 X 值或 Y 值
• 使用字体、颜色、背景、边框和圆角样式设置标签
• 使用系列调色板颜色作为标签背景
• 应用边距并自定义标签外观

图例

📄 阅读： references/legend.md

当用户需要以下操作时：

• 添加并配置 ChartLegend，以显示分段信息
• 自定义图例标签样式（字体、颜色、大小、属性）
• 设置图例图标类型并自定义图标外观
• 设置图例位置（Top、Bottom、Left、Right）
• 使用偏移位置创建浮动图例
• 启用通过点击图例切换系列可见性的功能
• 使用 ItemsLayout 自定义图例布局
• 使用自定义图例项模板
• 处理 LegendItemCreated 事件
• 覆盖图例视图的最大尺寸请求

工具提示

📄 阅读： references/tooltip.md

当用户需要以下操作时：

• 启用工具提示，以便在悬停时显示分段信息
• 配置 ChartTooltipBehavior 以自定义工具提示
• 设置工具提示外观样式（背景、字体、颜色、边距）
• 控制工具提示的显示时长
• 为高级 UI 创建自定义工具提示模板
• 将工具提示内容绑定到数据项属性

外观和自定义

📄 阅读： references/appearance-customization.md

当用户需要：

• 为金字塔分段应用自定义调色板画笔
• 使用渐变填充（LinearGradientBrush、RadialGradientBrush）
• 在 Linear 和 Surface 金字塔模式之间切换
• 了解模式差异（基于高度与基于面积）
• 使用 GapRatio 属性控制分段间距
• 实现视觉样式设计最佳实践
• 为分段创建精细的渐变效果

导出

📄 阅读： references/exporting.md

当用户需要：

• 将金字塔图表导出为图像（JPEG 或 PNG）
• 使用 SaveAsImage 方法导出文件
• 了解特定平台的保存位置
• 配置 Android 和 Windows Phone 的文件写入权限
• 设置 iOS 相册访问权限
• 使用 GetStreamAsync 将图表导出为流
• 将图表流与 PDF、Excel 或 Word 组件集成
• 处理 ImageFileFormat 选项