ReoGrid 支持多种图表类型，可以作为浮动对象显示在工作表上。图表在其数据源发生更改时会自动更新，并且会随 Excel 文件一起保存/加载。

命名空间

using unvell.ReoGrid.Chart;
using unvell.ReoGrid.Drawing;

可用的图表类型

类	示例	说明
ColumnChart		垂直柱状图
BarChart		水平条形图
LineChart		折线图
AreaChart		填充面积图
Pie2DChart		2D 饼图
DoughnutChart		环形图

创建图表

步骤 1：准备数据

var sheet = grid.CurrentWorksheet;

sheet["A2"] = new object[,] {
    { null, 2008, 2009, 2010, 2011, 2012 },
    { "City 1", 3, 2, 4, 2, 6 },
    { "City 2", 7, 5, 3, 6, 4 },
    { "City 3", 13, 10, 9, 10, 9 },
};

步骤 2：定义范围

var dataRange = sheet.Ranges["B3:F5"];           // 数值数据
var serialNamesRange = sheet.Ranges["A3:A5"];    // 系列名称（行标题）
var categoryNamesRange = sheet.Ranges["B2:F2"];  // 类别名称（列标题）

步骤 3：创建图表

var chart = new ColumnChart
{
    Location = new Graphics.Point(220, 160),
    Size = new Graphics.Size(400, 260),
    Title = "Column Chart Sample",
    DataSource = new WorksheetChartDataSource(sheet, serialNamesRange, dataRange)
    {
        CategoryNameRange = categoryNamesRange,
    },
};

步骤 4：添加到工作表

sheet.FloatingObjects.Add(chart);

图表属性

所有图表类型都继承自 Chart 基类：

事件

数据源

WorksheetChartDataSource

将工作表数据连接到图表：

// 使用范围的构造函数
var dataSource = new WorksheetChartDataSource(sheet, serialNamesRange, dataRange)
{
    CategoryNameRange = categoryNamesRange,
};

// 使用字符串地址的构造函数
var dataSource = new WorksheetChartDataSource(sheet, "A3:A5", "B3:F5")
{
    CategoryNameRange = sheet.Ranges["B2:F2"],
};

构造函数

属性

方法

事件

WorksheetChartDataSerial

表示图表中的一个数据系列：

数据系列样式

自定义每个数据系列的外观：

// 按索引访问样式
var style = chart.DataSerialStyles[0];

示例：半透明面积图

foreach (var style in chart.DataSerialStyles)
{
    style.FillColor = new Graphics.SolidColor(100, style.FillColor.ToSolidColor());
}

图例

控制图表图例：

// 隐藏图例
chart.ShowLegend = false;

// 访问图例属性
var legend = chart.PrimaryLegend;

LegendPosition 枚举

坐标轴配置（仅限坐标轴图表）

柱状图、条形图、折线图和面积图继承自 AxisChart，支持坐标轴配置：

AxisDataInfo 属性

高亮范围

在工作表上高亮显示数据范围，以直观地指示图表的数据源：

sheet.AddHighlightRange(dataRange);
sheet.AddHighlightRange(serialNamesRange);
sheet.AddHighlightRange(categoryNamesRange);

图表类型详情

类层次结构

FloatingObject
  └─ DrawingObject
      └─ DrawingComponent
          └─ Chart (base)
              ├─ AxisChart
              │   ├─ ColumnChart
              │   │   └─ BarChart
              │   ├─ LineChart
              │   └─ AreaChart
              └─ PieChart
                  ├─ Pie2DChart
                  └─ DoughnutChart

相关主题

• 浮动对象 — 管理工作表上的浮动对象
• 绘图形状 — 绘图形状 API