图表标题

在 GcExcel Java 中, 可以使用 IChart 接口的方法来配置所选的图表标题。

可以通过以下方式使用图表标题:

设置图表标题的公式

要设置图表标题的公式，请参阅以下示例代码。

// Set formula for chart title.
shape.getChart().setHasTitle(true);
shape.getChart().getChartTitle().getTextFrame().getTextRange().getParagraphs().add("ChartSubtitle");
shape.getChart().getChartTitle().getTextFrame().getTextRange().getParagraphs().add("ChartTitle", 0);

设置图表标题和字体样式的格式

要设置图表标题和字体样式的格式，请参阅以下示例代码。

// Set chart titale's format and font style.
shape.getChart().setHasTitle(true);
//shape.getChart().getChartTitle().setText("MyChartTitle");
shape.getChart().getChartTitle().getFormat().getFill().getColor().setRGB(Color.GetDarkOrange());
shape.getChart().getChartTitle().getFormat().getLine().getColor().setRGB(Color.GetCornflowerBlue());

设置图表标题的方向

您可以将图表标题的方向设置为水平、垂直、旋转（90度或270度）以及堆叠（从左到右或从右到左读取文本）。IChartTitle和IChartTitle.ITextFrame接口中的setDirection 方法允许您使用TextDirection枚举设置图表标题的方向。

请参考以下示例代码，将图表标题的方向设置为垂直：

// 创建图表。
shape.getChart().getSeriesCollection().add(worksheet.getRange("A1:D6"), RowCol.Columns, true, true);

// 显示图表标题。
shape.getChart().setHasTitle(true);

// 设置图表标题名称。
shape.getChart().getChartTitle().setText("Chart Title");

// 将图表标题的方向设置为垂直。
shape.getChart().getChartTitle().getTextFrame().setDirection(TextDirection.Vertical);

// 或者
shape.getChart().getChartTitle().setDirection(TextDirection.Vertical);

设置图表标题的文本角度

您还可以使用IChartTitle界面的setOrientation方法配置图表标题的文本角度。文本角度也可以导出或导入为JSON。

请参阅以下示例代码以设置图表标题的文本角度。

 //create a new workbook
  Workbook workbook = new Workbook();
 // Fetch default worksheet
 IWorksheet worksheet = workbook.getWorksheets().get(0);

 //add chart
 IShape shape = worksheet.getShapes().addChart(ChartType.ColumnClustered, 250, 20, 360, 230);
 worksheet.getRange("A1:D6").setValue(new Object[][]
 {
{null, "S1", "S2", "S3"},
{"Item1", 10, 25, 25},
{"Item2", -20, 36, 27},
{"Item3", 62, 70, -30},
{"Item4", 22, 65, 65},
{"Item5", 23, 50, 50}
 });
 shape.getChart().getSeriesCollection().add(worksheet.getRange("A1:D6"), RowCol.Columns, true, true);

 //add chart title
 shape.getChart().setHasTitle(true);
 
 shape.getChart().getChartTitle().setText("MyChartTitle");

 //config chart title angle
 shape.getChart().getChartTitle().setOrientation(30);

 //save to an excel file
 workbook.save("configcharttitleangle.xlsx");