运行时动态创建cxGrid DBChartView及数据绑定咨询
运行时动态创建cxGrid DBChartView 动态绑定实现指南
问题场景
- 业务目标:运行时动态创建cxGrid的DBChartView视图,实现1个核心数据指标系列搭配N个动态生成分组的图表展示效果
- 约束条件:所有数据来自运行时查询结果,ClientDataSet字段、图表结构均无法在设计期提前配置,必须完全通过代码动态完成绑定
- 已尝试无效的操作:
- 直接调用
gridMainDBChartView1.CreateSeries创建无类型系列后,直接给Series[0].DataBinding赋值字段名 - 尝试通过组件属性路径配置
Series.DataBinding.FieldName、ValueType属性,发现这类属性在IDE设计期的组件预览中不显示,配置不生效 - 检索公开资料仅能找到基于本地静态变量的图表创建方法,无适配动态数据库绑定场景的说明
- 直接调用
可落地的实现步骤
- 第一步:优先完成视图级基础数据源绑定
- 给DBChartView实例的
DataSource属性指向已完成数据加载、字段定义的ClientDataSet实例,这是所有后续系列、分组绑定生效的核心前提,跳过这步会出现所有绑定配置完成但图表无渲染数据的问题
- 给DBChartView实例的
- 第二步:创建强类型的数据系列,避免无类型创建导致的属性不可用问题
- 不要直接调用无参数的
CreateSeries方法,要在创建时明确指定系列的实际类型(如柱状图用TcxGridDBChartBarSeries、折线图用TcxGridDBChartLineSeries、饼图用TcxGridDBChartPieSeries),强类型实例才能暴露完整的DataBinding配置属性 - 参考代码:
// 创建柱状图类型的指标系列 var IndicatorSeries: TcxGridDBChartBarSeries; IndicatorSeries := gridMainDBChartView1.CreateSeries(TcxGridDBChartBarSeries) as TcxGridDBChartBarSeries; - 不要直接调用无参数的
- 第三步:配置系列的数值绑定规则
- 通过强类型的系列实例访问DataBinding属性,设置
IndicatorSeries.DataBinding.FieldName为要展示的指标类字段名 - 显式设置
IndicatorSeries.DataBinding.ValueType为匹配需求的聚合类型(如求和用cvvtSum、平均值用cvvtAverage、最大值用cvvtMax),未显式指定该属性时,哪怕字段名配置正确,图表也不会拉取对应数据
- 通过强类型的系列实例访问DataBinding属性,设置
- 第四步:动态创建N个分组维度
- 不要把分组维度塞进指标系列的绑定配置里,DBChartView的分组X轴维度是独立的DataGroups集合管理的
- 循环N次创建对应的
TcxGridDBChartDataGroup实例,给每个实例设置DataBinding.FieldName为对应的分组字段名,最后把实例加入视图的DataGroups集合即可完成分组配置 - 参考代码:
// 动态循环创建分组,适配N个动态分组的需求 var ChartGroup: TcxGridDBChartDataGroup; ChartGroup := gridMainDBChartView1.DataGroups.CreateItem as TcxGridDBChartDataGroup; ChartGroup.DataBinding.FieldName := '对应分组的字段名'; gridMainDBChartView1.DataGroups.Add(ChartGroup);
常见踩坑提示
- IDE设计期看不到
DataBinding下的子属性属于正常现象:这类属性只有在系列实例被指定为具体的强类型类时,才会在对象查看器中暴露,不是属性不存在的问题 - 不要单独给系列指定数据源:DBChartView的渲染逻辑统一读取视图级的DataSource配置,单独给系列配数据集不会被识别
- 所有字段名必须和ClientDataSet中动态创建的字段名完全一致,大小写不匹配也会导致绑定失效
内容的提问来源于stack exchange,提问作者Denis Ndoja
相关产品推荐
相关产品推荐

