Kontroller i diagram

Ibland behöver du infoga ritobjekt som etiketter, textrutor, bilder och så vidare i ett diagram. Aspose.Cells kan lägga till kontrollerna i ett diagram vid körning.

Lägger till etikettkontroll till diagrammet

Etiketter är ett sätt att ge användarna information om innehållet i ett kalkylblad. Aspose.Cells låter dig lägga till och manipulera etiketter även i diagram.

DeShapeCollection klass tillhandahåller en metod som heteraddLabelInChart, används för att lägga till en etikettkontroll till ett diagram. Nedan är en lista över de parametrar som används för metoden:

• topp – etikettens vertikala förskjutning från det övre vänstra hörnet i enheter om 1/4000 av kartytan.
• vänster – etikettens vertikala förskjutning från det övre vänstra hörnet i enheter om 1/4000 av kartytan.
• höjd – etikettens höjd, i enheter om 1/4000 av kartytan.
• bredd – etikettens bredd, i enheter om 1/4000 av kartytan.

Metoden returnerar ett objekt avMärka klass, därMärkaklass representerar en etikett i diagrammet. Den har några viktiga medlemmar som beskrivs nedan:

• Textegenskapen anger en etiketts bildtextsträng.
• Fylla egenskapen anger fyllningsfärgsattributen.

Följande exempel visar hur du lägger till en etikett i diagrammet. Exemplet använder en designerfil som har ett diagram i sig. Vi använder den här filen för att infoga en etikett i diagrammet.

Nedan finns en skärmdump av designerfilen.

Designerdiagrammet

Nedan finns den ursprungliga koden för att lägga till en etikett i diagrammet. Följande utdata genereras när koden exekveras.

En etikett läggs till i diagrammet

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

Lägga till TextBox Control till diagrammet

Ett sätt att lyfta fram viktig information i en rapport är att använda en textruta. Ange till exempel text för att markera företagsnamnet eller för att ange den geografiska region med högst försäljning. DeShapeCollection klass tillhandahåller en metod som heteraddTextBoxInChart, som används för att lägga till en textrutekontroll till ett diagram. Följande är parameterlistan som används för metoden:

• topp – den vertikala förskjutningen av textrutan från det övre vänstra hörnet i enheter på 1/4000 av sjökortsytan.
• vänster – den vertikala förskjutningen av textrutan från det övre vänstra hörnet i enheter på 1/4000 av sjökortsytan.
• höjd– textrutans höjd, i enheter om 1/4000 av kartytan.
• bredd – textrutans bredd, i enheter om 1/4000 av kartytan.

Metoden returnerar ett objekt avTextruta klass därTextrutaklass representerar en textruta i diagrammet.

Följande exempel visar hur man lägger till en textruta i ett diagram. Exemplet använder den tidigare designerfilen som har ett diagram i sig. Vi använder den här filen för att infoga en textruta i diagrammet för att visa diagrammets titel.

Nedan finns den ursprungliga koden för att lägga till en textruta i diagrammet. Följande utdata genereras när koden exekveras.

En textruta läggs till i diagrammet

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

Lägger till bild till diagrammet

Aspose.Cells låter dig infoga bilder i ett diagram. Till exempel, lägg till en bild för att framhäva eller ge mer mening åt ett diagram eller dess innehåll, eller infoga en varumärkesbildsfil.

DeShapeCollection klass tillhandahåller en metod som heteraddPictureInChart, som används för att lägga till ett bildobjekt i diagrammet. Följande är parameterlistan som används för metoden:

• topp– bildens vertikala förskjutning från det övre vänstra hörnet i enheter om 1/4000 av sjökortsytan.
• vänster– bildens vertikala förskjutning från det övre vänstra hörnet i enheter om 1/4000 av sjökortsytan.
• ström – ett strömobjekt som innehåller bilddata.
• breddSkala – skalan för bildens bredd, ett procentuellt värde.
• höjdskala – skalan för bildhöjd, ett procentuellt värde.

Metoden returnerar ett objekt avBild klass därBildklass representerar ett bildobjekt i diagrammet.

Följande exempel visar hur man lägger till en bild i diagrammet. Exemplet använder den tidigare designerfilen som har ett diagram i sig. Vi använder den här filen för att infoga en bild i diagrammet.

Nedan finns den ursprungliga koden för att lägga till en bild i diagrammet. Följande utdata genereras när koden exekveras

En bild infogas i diagrammet

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

Lägger till kryssruta i diagrammet

Aspose.Cells låter dig infoga kryssrutor i ett diagramblad med hjälp avMsoDrawingType uppräkning. Följande exempel visar hur du lägger till en kryssruta i ett diagramblad.

Följande bild visar diagrambladet med kryssrutan i utdatafilen.

Deutdatafilsom genereras av följande kodavsnitt bifogas för din referens.

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