Элементы управления в диаграммах

Иногда вам нужно вставить в диаграмму объекты рисования, такие как метки, текстовые поля, изображения и т. д. Aspose.Cells может добавлять элементы управления на диаграмму во время выполнения.

Добавление элемента управления Label на диаграмму

Метки предоставляют средства для предоставления пользователям информации о содержимом электронной таблицы. 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.");

Добавление элемента управления TextBox на диаграмму

Один из способов выделить важную информацию в отчете — использовать текстовое поле. Например, введите текст, чтобы выделить название компании или указать географический регион с самыми высокими продажами.Коллекция форм класс предоставляет метод с именемаддтекстбоксинчарт, который используется для добавления элемента управления текстовым полем на диаграмму. Ниже приведен список параметров, используемых для метода:

• вершина – вертикальное смещение текстового поля от верхнего левого угла в единицах 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 позволяет вставлять изображения в диаграмму. Например, добавьте изображение, чтобы подчеркнуть или придать больше смысла диаграмме или ее содержимому, или вставьте файл изображения бренда.

Коллекция форм класс предоставляет метод с именемдобавитьPictureInChart, который используется для добавления объекта изображения на диаграмму. Ниже приведен список параметров, используемых для метода:

• вершина– смещение картинки по вертикали от левого верхнего угла в единицах 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 позволяет вставлять флажки в лист диаграммы с помощьюМсодравингтипе перечисление. В следующем примере показано добавление флажка на лист диаграммы.

На следующем изображении показан лист диаграммы с флажком в выходном файле.

выходной файлсгенерированный следующим фрагментом кода, прилагается для справки.

// 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");