总体汇总是对所有节点或根结点进行汇总计算。 本主题描述如何在 TreeList 控件中实现总体汇总。
总体汇总(Total Summaries)
实现总体汇总的基本步骤如下:
- 指定列的总体汇总类型。
把 TreeListColumn.SummaryFooter 属性设置为所需的聚合函数类型 (除了 SummaryItemType.None 之外);
- 指定总体汇总是否只计算根结点,还是计算所有节点。
使用 TreeListColumn.AllNodesSummary 属性启用对所有节点计算汇总。 在默认情况下,此属性被设置为 false。
- 使 汇总脚注 可视。
总体汇总被显示在 汇总脚注 中。 因此启用 TreeListOptionsView.ShowSummaryFooter 选项来查看总体汇总值。
另外,可以指定总体汇总值的格式。 要执行此任务,则使用 TreeListColumn.SummaryFooterStrFormat 属性。 请参阅 设置汇总值的格式 主题来学习更多内容。
示例
下面的示例演示了如何计算绑定到“Size(Bytes)”字段的列的合计。 通过 TreeListColumn.SummaryFooter 和 TreeListColumn.SummaryFooterStrFormat 属性设置函数类型和汇总值的格式。
TreeListColumn.AllNodesSummary 属性值被设置为 true,以计算控件中所有节点的汇总。 启用了 TreeListOptionsView.ShowSummaryFooter 选项来显示汇总脚注。
C# | ![]() |
---|---|
using DevExpress.XtraTreeList; using DevExpress.XtraTreeList.Columns; // ... treeList1.OptionsView.ShowSummaryFooter = true; TreeListColumn column = treeList1.Columns["Size(Bytes)"]; column.AllNodesSummary = true; column.SummaryFooterStrFormat = "Total Sum {0:n0}"; column.SummaryFooter = SummaryItemType.Sum; |
Visual Basic | ![]() |
---|---|
Imports DevExpress.XtraTreeList Imports DevExpress.XtraTreeList.Columns ' ... TreeList1.OptionsView.ShowSummaryFooter = True Dim Column As TreeListColumn = TreeList1.Columns("Size(Bytes)") Column.AllNodesSummary = True Column.SummaryFooterStrFormat = "Total Sum {0:n0}" Column.SummaryFooter = SummaryItemType.Sum |