Public API Changements dans Aspose.Cells 8.5.2

Ce document décrit les modifications apportées au Aspose.Cells API de la version 8.5.1 à 8.5.2 qui peuvent intéresser les développeurs de modules/applications. Il comprend non seulement des méthodes publiques nouvelles et mises à jour,classes ajoutées, etc., mais aussi une description de tout changement de comportement dans les coulisses du Aspose.Cells.

API ajoutées

Rendre la feuille de calcul dans le contexte graphique

Cette version de Aspose.Cells for .NET API a exposé deux nouvelles surcharges de la méthode SheetRender.ToImage qui permettent désormais d’accepter une instance de la classe System.Drawing.Graphics pourrendu dans le contexte graphique. Les signatures des méthodes nouvellement ajoutées sont les suivantes.

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)

Voici le scénario d’utilisation 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éthode PivotTable.GetCellByDisplayName ajoutée

Aspose.Cells for .NET 8.5.2 a exposé la méthode PivotTable.GetCellByDisplayName qui peut être utilisée pourrécupérer l’objet Cell par le nom du PivotField. Cette méthode peut être utile dans les scénarios où vous souhaitez mettre en surbrillance ou formater l’en-tête PivotField.

Voici le scénario d’utilisation 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");

Propriété SaveOptions.MergeAreas ajoutée

Aspose.Cells for .NET 8.5.2 a exposé la propriété SaveOptions.MergeAreas qui peut accepter une valeur de type booléen. La valeur par défaut est false cependant, si elle est définie sur true, le Aspose.Cells for .NET API essaie de fusionner la CellArea individuelle avant d’enregistrer le fichier.

Si une feuille de calcul contient trop de cellules individuelles avec validation appliquée, il est possible que la feuille de calcul résultante soit corrompue. Une solution possible consiste à fusionner les cellules avec des règles de validation identiques ou vous pouvez maintenant utiliser la propriété SaveOptions.MergeAreas pour demander au API de fusionner automatiquement les CellAreas avant l’opération d’enregistrement.

Propriété Shape.Geometry.ShapeAdjustValues ajoutée

Avec la version v8.5.2, le Aspose.Cells API a exposé la propriété Shape.Geometry.ShapeAdjustValues qui peut être utilisée pourapporter des modifications aux points de réglage de différentes formes.

Dans l’interface Excel Microsoft, les points de réglage s’affichent sous forme de nœuds en losange jaune.

Par exemple,

1. Le rectangle arrondi a un ajustement pour changer l’arc
2. Triangle a un ajustement pour changer l’emplacement du point
3. Le trapèze a un ajustement pour changer la largeur du haut
4. Les flèches ont deux ajustements pour changer la forme de la tête et de la queue

Voici le scénario d’utilisation le plus 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);

Champ d’énumération ConsolidationFunction.DistinctCount ajouté

Aspose.Cells for .NET 8.5.2 a exposé le champ ConsolidationFunction.DistinctCount qui peut être utilisé pourappliquer la fonction de consolidation Distinct Count sur DataField d’un tableau croisé dynamique.

La fonction de consolidation Distinct Count est prise en charge par Microsoft Excel 2013 uniquement.

Meilleure gestion des événements pour GridDesktop

Cette version de Aspose.Cells.GridDesktop a exposé 4 nouveaux événements. 2 de ces événements se déclenchent sur différents états de chargement des fichiers de feuille de calcul dans GridDesktop tandis que les 2 autres se déclenchent lors du calcul des formules.

Les événements sont répertoriés comme suit.

1. GridDesktop.BeforeLoadFileGridDesktop.BeforeLoadFile
2. GridDesktop.FinishLoadFileGridDesktop.FinishLoadFile
3. GridDesktop.BeforeCalculate
4. GridDesktop.FinishCalculateGridDesktop.FinishCalculate