Pubblico API Modifiche Aspose.Cells 8.5.2

Questo documento descrive le modifiche allo Aspose.Cells API dalla versione 8.5.1 alla 8.5.2 che potrebbero interessare gli sviluppatori di moduli/applicazioni. Include non solo metodi pubblici nuovi e aggiornati,classi aggiunte ecc., ma anche una descrizione di eventuali cambiamenti nel comportamento dietro le quinte in Aspose.Cells.

API aggiunte

Renderizza il foglio di lavoro nel contesto grafico

Questa versione di Aspose.Cells for .NET API ha esposto due nuovi overload del metodo SheetRender.ToImage che ora consente di accettare un’istanza della classe System.Drawing.Graphics perrendere nel contesto della grafica. Le firme dei nuovi metodi aggiunti sono le seguenti.

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)

Di seguito è riportato il semplice scenario di utilizzo.

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

Metodo PivotTable.GetCellByDisplayName aggiunto

Aspose.Cells for .NET 8.5.2 ha esposto il metodo PivotTable.GetCellByDisplayName che può essere utilizzato perrecuperare l’oggetto Cell con il nome del PivotField. Questo metodo potrebbe essere utile negli scenari in cui si desidera evidenziare o formattare l’intestazione PivotField.

Di seguito è riportato il semplice scenario di utilizzo.

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

Proprietà SaveOptions.MergeAreas aggiunta

Aspose.Cells for .NET 8.5.2 ha esposto la proprietà SaveOptions.MergeAreas che può accettare un valore di tipo booleano. Il valore predefinito è false tuttavia, se impostato su true, Aspose.Cells for .NET API tenta di unire la singola CellArea prima di salvare il file.

Se un foglio di calcolo ha troppe singole celle con convalida applicata, è possibile che il foglio di calcolo risultante venga danneggiato. Una possibile soluzione consiste nell’unire le celle con regole di convalida identiche oppure è ora possibile utilizzare la proprietà SaveOptions.MergeAreas per indicare a API di unire automaticamente CellAreas prima dell’operazione di salvataggio.

Proprietà Shape.Geometry.ShapeAdjustValues aggiunta

Con il rilascio della v8.5.2, Aspose.Cells API ha esposto la proprietà Shape.Geometry.ShapeAdjustValues che può essere utilizzata perapportare modifiche ai punti di regolazione di diverse forme.

Nell’interfaccia Excel Microsoft, i punti di regolazione vengono visualizzati come nodi romboidali gialli.

Ad esempio,

1. Rettangolo arrotondato ha una regolazione per cambiare l’arco
2. Triangolo ha una regolazione per cambiare la posizione del punto
3. Il trapezio ha una regolazione per modificare la larghezza della parte superiore
4. Le frecce hanno due regolazioni per cambiare la forma della testa e della coda

Ecco lo scenario di utilizzo più semplice.

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

Campo di enumerazione ConsolidationFunction.DistinctCount Added

Aspose.Cells for .NET 8.5.2 ha esposto il campo ConsolidationFunction.DistinctCount che può essere utilizzato perapplicare la funzione di consolidamento Distinct Count su DataField di una tabella pivot.

La funzione di consolidamento Distinct Count è supportata solo da Microsoft Excel 2013.

Migliore gestione degli eventi per GridDesktop

Questa versione di Aspose.Cells.GridDesktop ha esposto 4 nuovi eventi. 2 di questi eventi si attivano in diversi stati di caricamento dei file del foglio di calcolo in GridDesktop, mentre gli altri 2 si attivano al calcolo delle formule.

Gli eventi sono elencati come segue.

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