Cambios en la API pública en Aspose.Cells 8.5.2

Este documento describe los cambios en la API de Aspose.Cells desde la versión 8.5.1 hasta la 8.5.2 que pueden ser de interés para los desarrolladores de módulos/aplicaciones. Incluye no solo nuevos y actualizados métodos públicos, clases añadidas, etc., sino también una descripción de cualquier cambio en el comportamiento detrás de escena en Aspose.Cells.

APIs Añadidas

Renderizar la hoja de cálculo en contexto gráfico

Esta versión de la API Aspose.Cells for Java ha expuesto otra sobrecarga del método SheetRender.toImage que ahora permite aceptar una instancia de la clase Graphics2D para representar la hoja de cálculo en un contexto gráfico. Las firmas del método recién agregado son las siguientes.

• SheetRender.toImage(int pageIndex, Graphics2D graphic)

A continuación se muestra un escenario de uso simple.

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

Se agregó el método PivotTable.getCellByDisplayName

Aspose.Cells for Java 8.5.2 ha expuesto el método PivotTable.getCellByDisplayName que puede ser utilizado para recuperar el objeto Cell por el nombre del PivotField. Este método podría ser útil en escenarios donde desee resaltar o formatear el encabezado del PivotField.

A continuación se muestra un escenario de uso simple.

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

Se agregó la propiedad SaveOptions.MergeAreas

Aspose.Cells for Java 8.5.2 ha expuesto la propiedad SaveOptions.MergeAreas que puede aceptar un valor de tipo Booleano. El valor predeterminado es false, sin embargo, si se establece en true, la API Aspose.Cells for Java intenta fusionar el CellArea individual antes de guardar el archivo.

Si una hoja de cálculo tiene demasiadas celdas individuales con validación aplicada, existe la posibilidad de que la hoja de cálculo resultante se corrompa. Una posible solución es fusionar las celdas con reglas de validación idénticas o ahora puede usar la propiedad SaveOptions.MergeAreas para indicar a la API que fusione automáticamente las CellAreas antes de la operación de guardado.

Se agregó la propiedad Geometry.ShapeAdjustValues

Con la versión 8.5.2, la API Aspose.Cells ha expuesto el método Geometry.getShapeAdjustValues que se puede utilizar para acceder y realizar cambios en los puntos de ajuste de diferentes formas.

En la interfaz de Microsoft Excel, los puntos de ajuste se muestran como nodos de diamante amarillos.

Por ejemplo,

1. El rectángulo redondeado tiene un ajuste para cambiar el arco
2. El triángulo tiene un ajuste para cambiar la ubicación del punto
3. El trapecio tiene un ajuste para cambiar el ancho de la parte superior
4. Las flechas tienen dos ajustes para cambiar la forma de la cabeza y la cola

Aquí se presenta el escenario de uso más simple.

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

Se agregó el campo de enumeración ConsolidationFunction.DISTINCT_COUNT

Aspose.Cells for Java 8.5.2 ha expuesto el campo ConsolidationFunction.DISTINCT_COUNT que se puede usar para aplicar la función consolidada de Distinct Count en DataField de un PivotTable.

La función de consolidación de conteo distintivo es compatible solo con Microsoft Excel 2013.