Previous topicNext topic
Help > 开发指南 > Excel > API > 示例 > Chart图表 >
如何：显示或隐藏图表图例

创建图表后，将显示其图例。图表图例是一个框，用于标识图表上显示的数据系列。在大多数情况下，图例显示序列名称，但在饼图或圆环图中，它显示单个序列的数据点。图例还添加了用于在图表上绘制序列的线型、颜色和填充图案的示例。

Legend 对象定义图表图例。使用 ChartObject.Legend 属性检索对象。若要指定图例位置，请使用 Legend.Position 属性。将 Legend.Overlay 属性设置为以节省图表中的空间并启用图例叠加。若要删除图例，请将 Legend.Visible 属性设置为 。Legendtruefalse

Vb.Net
Dim worksheet As DevExpress.Spreadsheet.Worksheet = workbook.Worksheets("chartStock")
workbook.Worksheets.ActiveWorksheet = worksheet

'创建图表并指定其位置。
Dim chart As DevExpress.Spreadsheet.Charts.Chart = worksheet.Charts.Add(DevExpress.Spreadsheet.Charts.ChartType.ColumnClustered, worksheet("B2:F6"))
chart.TopLeftCell = worksheet.Cells("H2")
chart.BottomRightCell = worksheet.Cells("N14")

'指定图例的位置。
chart.Legend.Position = DevExpress.Spreadsheet.Charts.LegendPosition.Bottom

C#
DevExpress.Spreadsheet.Worksheet worksheet = workbook.Worksheets["chartStock"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// 创建图表并指定其位置。
DevExpress.Spreadsheet.Charts.Chart chart = worksheet.Charts.Add(DevExpress.Spreadsheet.Charts.ChartType.ColumnClustered, worksheet["B2:F6"]);
chart.TopLeftCell = worksheet.Cells["H2"];
chart.BottomRightCell = worksheet.Cells["N14"];

// 指定图例的位置。
chart.Legend.Position = DevExpress.Spreadsheet.Charts.LegendPosition.Bottom;

更改图例条目

Legend.CustomEntries 属性获取自定义图例条目的集合 （LegendEntryCollection）。您可以使用此集合来修改各个图例条目。

若要隐藏图例条目，请将 LegendEntry 实例添加到集合中，并将索引设置为所选条目的索引。将 LegendEntry.Hidden 属性设置为 。LegendEntry.Font 属性允许您更改单个条目的字体属性。true

注意

电子表格控件不会为属性指定的每个图例条目显示单独的字体 。该属性指定的字体 将应用于所有条目。但是，可以在代码中检索该属性，以支持的格式导出该属性，并在 Microsoft Excel 中可视化该属性。LegendEntry.FontLegend.FontLegendEntry.Font

如果未指定该属性，但一个或多个图例条目指定了该属性，则从集合中的第一个条目中检索字体。Legend.FontFont

下面的示例从图表图例中删除条目。

Vb.Net
Dim worksheet As DevExpress.Spreadsheet.Worksheet = workbook.Worksheets("chartStock")
workbook.Worksheets.ActiveWorksheet = worksheet

'创建图表并指定其位置。
Dim chart As DevExpress.Spreadsheet.Charts.Chart = worksheet.Charts.Add(DevExpress.Spreadsheet.Charts.ChartType.ColumnClustered, worksheet("B2:F6"))
chart.TopLeftCell = worksheet.Cells("H2")
chart.BottomRightCell = worksheet.Cells("N14")

'从图例中排除条目。
chart.Legend.CustomEntries.Add(2).Hidden = True
chart.Legend.CustomEntries.Add(3).Hidden = True

C#
DevExpress.Spreadsheet.Worksheet worksheet = workbook.Worksheets["chartStock"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// 创建图表并指定其位置。
DevExpress.Spreadsheet.Charts.Chart chart = worksheet.Charts.Add(DevExpress.Spreadsheet.Charts.ChartType.ColumnClustered, worksheet["B2:F6"]);
chart.TopLeftCell = worksheet.Cells["H2"];
chart.BottomRightCell = worksheet.Cells["N14"];

// 从图例中排除条目。
chart.Legend.CustomEntries.Add(2).Hidden = true;
chart.Legend.CustomEntries.Add(3).Hidden = true;