图表中的控件

有时您需要将标签、文本框、图片等绘图对象插入到图表中。 Aspose.Cells 可以在运行时将控件添加到图表中。

向图表添加标签控件

标签提供了一种向用户提供有关电子表格内容的信息的方法。 Aspose.Cells 允许您甚至在图表中添加和操作标签。

这形状集合类提供了一个名为在图表中添加标签, 用于向图表添加标签控件。下面是用于该方法的参数列表：

• 最佳– 标签距左上角的垂直偏移量，以图表区域的 1/4000 为单位。
• 剩下– 标签距左上角的垂直偏移量，以图表区域的 1/4000 为单位。
• 高度– 标签的高度，以图表区域的 1/4000 为单位。
• 宽度 – 标签的宽度，以图表区域的 1/4000 为单位。

该方法返回一个对象标签类，其中标签类代表图表中的标签。它有一些重要的成员，详述如下：

• 文本属性指定标签的标题字符串。
• 充满属性指定填充颜色属性。

以下示例显示如何向图表添加标签。该示例使用其中包含图表的设计器文件。我们使用此文件将标签插入图表中。

下面是设计器文件的屏幕截图。

设计师图表

下面是向图表添加标签的原始代码。执行代码时会生成以下输出。

图表中添加了标签

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLabelControl.class) + "charts/";

String filePath = dataDir + "chart.xls";

Workbook workbook = new Workbook(filePath);

Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

Label label = chart.getShapes().addLabelInChart(100, 100, 350, 900);
label.setText("Write Label here");
label.setPlacement(PlacementType.FREE_FLOATING);
label.getFill().getSolidFill().setColor(Color.getChocolate());

// Output the file
workbook.save(dataDir + "ALControl_out.xls");

// Print message
System.out.println("Label added to chart successfully.");

将文本框控件添加到图表

在报告中突出显示重要信息的一种方法是使用文本框。例如，输入文本以突出显示公司名称或指示销售额最高的地理区域。这形状集合类提供了一个名为添加文本框图表，用于向图表添加文本框控件。以下是该方法使用的参数列表：

• 最佳 – 文本框距左上角的垂直偏移量，以图表区域的 1/4000 为单位。
• 剩下 – 文本框距左上角的垂直偏移量，以图表区域的 1/4000 为单位。
• 高度– 文本框的高度，以图表区域的 1/4000 为单位。
• 宽度 – 文本框的宽度，以图表区域的 1/4000 为单位。

该方法返回一个对象文本框上课的地方文本框类表示图表中的文本框。

以下示例显示如何向图表添加文本框。该示例使用以前的设计器文件，其中包含一个图表。我们使用此文件在图表中插入一个文本框以显示图表标题。

下面是向图表添加文本框的原始代码。执行代码时会生成以下输出。

图表中添加了一个文本框

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingTextBoxControl.class) + "charts/";
String filePath = dataDir + "chart.xls";

// Create a new Workbook.
// Open the existing file.
Workbook workbook = new Workbook(filePath);
Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

// Add a new textbox to the chart.
TextBox txt = chart.getShapes().addTextBoxInChart(100, 100, 850, 2500);
txt.setText("Aspose");
txt.getFont().setItalic(true);
txt.getFont().setSize(20);
txt.getFont().setBold(true);

// Get the filformat of the textbox.
FillFormat fillformat = txt.getFill();
fillformat.setFillType(FillType.SOLID);
fillformat.getSolidFill().setColor(Color.getSilver());

// Get the lineformat type of the textbox.
LineFormat lineformat = txt.getLine();
lineformat.setWeight(2);
lineformat.setDashStyle(MsoLineDashStyle.SOLID);

// Output the file
workbook.save(dataDir + "ATBoxControl_out.xls");

// Print message
System.out.println("TextBox added to chart successfully.");

添加图片到图表

Aspose.Cells 允许您将图像插入图表。例如，添加图片以强调或赋予图表或其内容更多含义，或插入品牌图像文件。

这形状集合类提供了一个名为添加画中画, 用于向图表添加图片对象。以下是该方法使用的参数列表：

• 最佳– 图片距左上角的垂直偏移量，以图表区域的 1/4000 为单位。
• 剩下– 图片距左上角的垂直偏移量，以图表区域的 1/4000 为单位。
• 溪流– 包含图像数据的流对象。
• 宽度比例– 图像宽度的比例，一个百分比值。
• 高度比例– 图像高度的比例，一个百分比值。

该方法返回一个对象图片上课的地方图片类代表图表中的图片对象。

下面的示例演示如何将图片添加到图表中。该示例使用以前的设计器文件，其中包含一个图表。我们使用此文件将图像插入图表中。

下面是向图表添加图片的原始代码。执行代码时产生如下输出

图表中插入了一张图片

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingPictureToChart.class) + "charts/";

String filePath = dataDir + "chart.xls";

FileInputStream stream = new FileInputStream(dataDir + "logo.jpg");

Workbook workbook = new Workbook(filePath);

Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

Picture pic = chart.getShapes().addPictureInChart(50, 50, stream, 40, 40);
LineFormat lineformat = pic.getLine();

lineformat.setFillType(FillType.SOLID);
lineformat.getSolidFill().setColor(Color.getBlue());
lineformat.setDashStyle(MsoLineDashStyle.DASH_DOT_DOT);
// Output the file
workbook.save(dataDir + "APToChart_out.xls");

// Print message
System.out.println("Picture added to chart successfully.");

在图表中添加复选框

Aspose.Cells 允许您使用Mso绘图类型枚举。以下示例演示了向图表工作表添加复选框。

下图显示了输出文件中带有复选框的图表工作表。

这输出文件附上由以下代码片段生成的代码供您参考。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// directories
String outputDir = Utils.Get_OutputDirectory();

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a chart to the worksheet
int index = workbook.getWorksheets().add(SheetType.CHART);

Worksheet sheet = workbook.getWorksheets().get(index);
sheet.getCharts().addFloatingChart(ChartType.COLUMN, 0, 0, 1024, 960);
sheet.getCharts().get(0).getNSeries().add("{1,2,3}", false);

// Add checkbox to the chart.
sheet.getCharts().get(0).getShapes().addShapeInChart(MsoDrawingType.CHECK_BOX, PlacementType.MOVE, 400, 400, 1000, 600);
sheet.getCharts().get(0).getShapes().get(0).setText("CheckBox 1");

// Convert chart to image with additional settings
workbook.save(outputDir + "InsertCheckboxInChartSheet_out.xlsx");