Offentlig API Ändringar i Aspose.Cells 8.5.2

Det här dokumentet beskriver ändringarna av Aspose.Cells API från version 8.5.1 till 8.5.2 som kan vara av intresse för modul-/applikationsutvecklare. Det inkluderar inte bara nya och uppdaterade offentliga metoder,lagt till klasser etc., men också en beskrivning av eventuella förändringar i beteendet bakom kulisserna i Aspose.Cells.

Lade till API:er

Återge arbetsblad till grafisk kontext

Den här utgåvan av Aspose.Cells for Java API har exponerat ytterligare en överbelastning av SheetRender.toImage-metoden som nu tillåter att en instans av Graphics2D-klassen accepteras tillrendera arbetsbladet i grafiksammanhang. Signaturerna för den nyligen tillagda metoden är följande.

• SheetRender.toImage(int pageIndex, Graphics2D-grafik)

Följande är det enkla användningsscenariot.

Java

 //Create workbook object from source file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

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

//Create empty image and fill it with blue color

int width = 800;

int height = 800;

BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);

Graphics2D g = image.createGraphics();

g.setColor(java.awt.Color.blue);

g.fillRect(0, 0, width, height);

//Set one page per sheet to true in image or print options

ImageOrPrintOptions opts = new ImageOrPrintOptions();

opts.setOnePagePerSheet(true);

//Render worksheet to graphics context

SheetRender sr = new SheetRender(worksheet, opts);

sr.toImage(0, g);

//Save the graphics context image in Png format

File outputfile = new File("test.png");

ImageIO.write(image, "png", outputfile);

Metod PivotTable.getCellByDisplayName tillagd

Aspose.Cells for Java 8.5.2 har exponerat metoden PivotTable.getCellByDisplayName som kan användas för atthämta objektet Cell med namnet PivotField. Den här metoden kan vara användbar i scenarier där du vill markera eller formatera PivotField-huvudet.

Följande är det enkla användningsscenariot.

Java

 //Create workbook object from source excel file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

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

//Access first pivot table inside the worksheet

PivotTable pivotTable = worksheet.getPivotTables().get(0);

//Access cell by display name of 2nd data field of the pivot table

String displayName = pivotTable.getDataFields().get(1).getDisplayName();

Cell cell = pivotTable.getCellByDisplayName(displayName);

//Access cell style and set its fill color and font color

Style style = cell.getStyle();

style.setForegroundColor(Color.getLightBlue());

style.getFont().setColor(Color.getBlack());

//Set the style of the cell

pivotTable.format(cell.getRow(), cell.getColumn(), style);

//Save workbook

workbook.save("output.xlsx");

Property SaveOptions.MergeAreas tillagd

Aspose.Cells for Java 8.5.2 har avslöjat egenskapen SaveOptions.MergeAreas som kan acceptera booleskt typvärde. Standardvärdet är falskt, men om det är satt till sant, försöker Aspose.Cells for Java API slå samman den individuella CellArea innan filen sparas.

Om ett kalkylark har för många enskilda celler med validering, finns det chanser att det resulterande kalkylarket kan skadas. En möjlig lösning är att slå samman cellerna med identiska valideringsregler eller så kan du nu använda egenskapen SaveOptions.MergeAreas för att styra API för att automatiskt sammanfoga CellAreas innan sparaoperationen.

Property Geometry.ShapeAdjustValues Added

Med lanseringen av v8.5.2 har Aspose.Cells API avslöjat metoden Geometry.getShapeAdjustValues som kan användas för attkomma åt och göra ändringar i justeringspunkterna för olika former.

I Microsoft Excel-gränssnittet visas justeringspunkterna som gula diamantnoder.

Till exempel,

1. Rundad rektangel har en justering för att ändra bågen
2. Triangeln har en justering för att ändra platsen för punkten
3. Trapets har en justering för att ändra toppens bredd
4. Pilarna har två justeringar för att ändra formen på huvudet och svansen

Här är det enklaste användningsscenariot.

Java

 //Create workbook object from source excel file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

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

//Access first three shapes of the worksheet

Shape shape1 = worksheet.getShapes().get(0);

Shape shape2 = worksheet.getShapes().get(1);

Shape shape3 = worksheet.getShapes().get(2);

//Change the adjustment values of the shapes

shape1.getGeometry().getShapeAdjustValues().get(0).setValue(0.5d);

shape2.getGeometry().getShapeAdjustValues().get(0).setValue(0.8d);

shape3.getGeometry().getShapeAdjustValues().get(0).setValue(0.5d);

//Save the workbook

workbook.save("output.xlsx");

Uppräkningsfält ConsolidationFunction.DISTINCT_COUNT har lagts till

Aspose.Cells for Java 8.5.2 har exponerat fältet ConsolidationFunction.DISTINCT_COUNT som kan användas för att tillämpa den konsoliderade funktionen Distinct Count på DataField i en pivottabell.

Funktionen Distinct Count-konsolidering stöds endast av Microsoft Excel 2013.