SuperAPI AI 工具集

syncfusion-maui-toolkit-pyramid-charts

数据与分析

查看项目

更新于 10-16 02:24

技能介绍

用途

本技能指导用户在 .NET MAUI 应用中实现 Syncfusion .NET MAUI 金字塔图(SfPyramidChart)。该控件用于可视化整体中各部分的比例,以层级分段的方式呈现,适合展示部分与整体的关系。它是无坐标轴的单系列图表,数据以百分比表示,各部分之和等于整体。

主要能力

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;样式化工具提示外观(背景、字体、颜色、边距);控制工具提示显示时长;创建自定义工具提示模板;将工具提示内容绑定到项数据属性。
  • 外观与自定义(references/appearance-customization.md):为金字塔分段应用自定义调色板画刷;使用渐变填充(LinearGradientBrush、RadialGradientBrush);在 Linear 与 Surface 模式间切换;理解两种模式的差异(基于高度与基于面积);通过 GapRatio 属性控制分段间距;实施视觉样式最佳实践;为分段创建精细的渐变效果。
  • 导出(references/exporting.md):将金字塔图导出为图片(JPEG 或 PNG);使用 SaveAsImage 方法导出文件;了解各平台特定的保存位置;为 Android 和 Windows Phone 配置文件写入权限;设置 iOS 相册访问权限;使用 GetStreamAsync 将图表导出为流;将图表流集成到 PDF、Excel 或 Word 组件中;处理 ImageFileFormat 选项。

适用场景

当用户需要以下操作时,可使用本技能:

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

限制

资料未提供关于收费、价格、平台兼容性范围、性能指标或具体效果的信息,暂未提供。