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 los métodos públicos nuevos y actualizados, 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 Aspose.Cells for .NET API ha expuesto dos nuevas sobrecargas del método SheetRender.ToImage que ahora permite aceptar una instancia de la clase System.Drawing.Graphics para renderizar en el contexto gráfico. Las firmas de los métodos recién agregados son las siguientes.

1. SheetRender.ToImage(int pageIndex, Graphics g, float x, float y)
2. SheetRender.ToImage(int pageIndex, Graphics g, float x, float y, float width, float height)

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

C#

 //Create workbook object from source file

Workbook workbook = new Workbook(filePath);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Create empty Bitmap

Bitmap bmp = new Bitmap(800, 800);

//Create Graphics Context

Graphics g = Graphics.FromImage(bmp);

g.Clear(Color.Blue);

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

ImageOrPrintOptions opts = new ImageOrPrintOptions();

opts.OnePagePerSheet = true;

//Render worksheet to graphics context

SheetRender sr = new SheetRender(worksheet, opts);

sr.ToImage(0, g, 0, 0);

//Save the graphics context image in Png format

bmp.Save("test.png", ImageFormat.Png);

Método Añadido PivotTable.GetCellByDisplayName

Aspose.Cells for .NET 8.5.2 ha expuesto el método PivotTable.GetCellByDisplayName que se puede utilizar para recuperar el objeto Cell por el nombre del Campo de Tabla Dinámica. Este método podría ser útil en escenarios donde desee resaltar o dar formato al encabezado del Campo de Tabla Dinámica.

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

C#

 //Create workbook object from source excel file

Workbook workbook = new Workbook(filePath);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access first pivot table inside the worksheet

PivotTable pivotTable = worksheet.PivotTables[0];

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

Cell cell = pivotTable.GetCellByDisplayName(pivotTable.DataFields[1].DisplayName);

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

Style style = cell.GetStyle();

style.ForegroundColor = Color.LightBlue;

style.Font.Color = Color.Black;

//Set the style of the cell

pivotTable.Format(cell.Row, cell.Column, style);

//Save workbook

workbook.Save("output.xlsx");

Se agregó la propiedad SaveOptions.MergeAreas

Aspose.Cells for .NET 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 .NET intenta fusionar las áreas de celda individuales 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.

Propiedad Añadida Shape.Geometry.ShapeAdjustValues

Con la versión v8.5.2, la API de Aspose.Cells ha expuesto la propiedad Shape.Geometry.ShapeAdjustValues que se puede utilizar para 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.

C#

 //Create workbook object from source excel file

Workbook workbook = new Workbook(filePath);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access first three shapes of the worksheet

Shape shape1 = worksheet.Shapes[0];

Shape shape2 = worksheet.Shapes[1];

Shape shape3 = worksheet.Shapes[2];

//Change the adjustment values of the shapes

shape1.Geometry.ShapeAdjustValues[0].Value = 0.5d;

shape2.Geometry.ShapeAdjustValues[0].Value = 0.8d;

shape3.Geometry.ShapeAdjustValues[0].Value = 0.5d;

//Save the workbook

workbook.Save("output.xls);

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

Aspose.Cells for .NET 8.5.2 ha expuesto el campo ConsolidationFunction.DistinctCount que se puede utilizar para aplicar la función de consolidación de recuento único en DataField de una tabla dinámica.

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

Mejor manejo de eventos para GridDesktop

Esta versión de Aspose.Cells.GridDesktop ha expuesto 4 eventos nuevos. 2 de estos eventos se activan en diferentes estados de carga de archivos de hojas de cálculo en GridDesktop, mientras que los otros 2 se activan al calcular fórmulas.

Los eventos se enumeran de la siguiente manera.

1. GridDesktop.BeforeLoadFile
2. GridDesktop.FinishLoadFile
3. GridDesktop.BeforeCalculate
4. GridDesktop.FinishCalculate