用途:在 WPF 应用中集成并配置 Syncfusion 的 SfHeatMap 控件,用颜色渐变呈现表格数据,便于快速识别数据模式与数值范围。这是一份偏实现的指南,重点说明需要配置什么以及原因,而非完整的 API 参考。
主要能力:支持 TableMapping 与 CellMapping 两种数据模型;通过 ColorMappingCollection 定义数值到颜色的映射;可搭配 SfHeatMapLegend 让色阶范围更清晰。
使用方式:在 XAML 中添加 SfHeatMap,提供 ItemsSource 与 ItemsMapping(TableMapping 或 CellMapping),添加 ColorMappingCollection 完成值到颜色的映射,可选地添加 SfHeatMapLegend。文档给出了语义分桶(红/黄/绿)的 XAML 与 C# 示例:定义 Value 为数值分档的 ColorMapping,配合 Label 文本;用 CellMapping 描述 行/列/值 三元组数据;图例 LegendMode 可设为 List 显示带标签的区间,也可用 Gradient 表示连续范围。
适用场景:需要把表格数据用颜色渐变可视化并快速发现模式与值域;行列为键的值三元组数据用 CellMapping,含多个数值属性(如以年份为列)的宽表对象用 TableMapping;当需要语义分档(差/中/好)或需要精确的范围到颜色映射时调整颜色映射。
限制与排查:颜色异常时检查 ColorMappingCollection 的值及数值范围是否与数据对齐;数据项不显示时确认 ItemsMapping 与 ItemsSource 的架构和键匹配。关于平台支持范围、版本要求、许可与收费等细节,资料暂未提供。