Changements de l API publique dans Aspose.Cells 17.1.0

Ce document décrit les changements apportés à l’API Aspose.Cells de la version 16.12.0 à la version 17.1.0 qui pourraient intéresser les développeurs de modules/applications. Il inclut non seulement les nouvelles méthodes publiques et mises à jour, les classes ajoutées et supprimées, mais aussi une description de tout changement de comportement en coulisses dans Aspose.Cells.

APIs ajoutées

Prise en charge des graphiques Excel 2016

Les APIs Aspose.Cells ont ajouté la prise en charge de quelques graphiques Excel 2016 en améliorant l’énumération ChartType. Les nouveaux champs suivants ont été ajoutés avec la version Aspose.Cells 17.1.0.

• ChartType.BoxWhisker : La série est disposée sous forme de boîte et de moustache.
• ChartType.Funnel : La série est disposée sous forme d’entonnoir.
• ChartType.ParetoLine : La série est disposée sous forme de lignes de Pareto.
• ChartType.Sunburst : La série est disposée sous forme de sunburst.
• ChartType.Treemap: La série est disposée sous forme de treemap.
• ChartType.Waterfall: La série est disposée sous forme de cascade.
• ChartType.Histogram: La série est disposée sous forme d’histogramme.

Consultez l’article détaillé sur Lecture des types de graphique Excel 2016

Setter ajouté pour la propriété LoadFilter.LoadDataFilterOptions

Aspose.Cells 17.1.0 a ajouté un setter pour la propriété LoadFilter.LoadDataFilterOptions pour remplacer la variable d’instance m_LoadDataFilterOptions. Les utilisateurs peuvent changer la propriété LoadDataFilterOptions dans leur propre implémentation de la classe LoadFilter pour changer le comportement du chargement des fichiers de modèle.

Voici un scénario d’utilisation simple.

Consultez l’article détaillé sur Filtrage de modèle personnalisé

C#

 class CustomFilter : Aspose.Cells.LoadFilter

{

    public override void StartSheet(Worksheet sheet)

    {

        if (sheet.Name == "Sheet1")

        {

            // Load everything

            this.LoadDataFilterOptions = LoadDataFilterOptions.All;

        }

        else

        {

            // Load nothing

            this.LoadDataFilterOptions = LoadDataFilterOptions.None;

        }

    }

}

Ajout de la propriété CellsHelper.SignificantDigits

Aspose.Cells 17.1.0 a exposé la propriété SignificantDigits de la classe CellsHelper qui permet de récupérer ou définir le nombre de chiffres significatifs pour les valeurs numériques dans une feuille de calcul. La valeur par défaut de la propriété CellsHelper.SignificantDigits est 17, elle s’applique uniquement si le résultat doit être stocké au format de fichier XLSX.

Voici un scénario simple pour démontrer l’utilisation de la propriété CellsHelper.SignificantDigits.

Consultez l’article détaillé sur Définition du nombre de chiffres significatifs

C#

 // Specify the number of significant digits

CellsHelper.SignificantDigits = 15;

Ajout de la propriété GlowEffect.Color

Aspose.Cells 17.1.0 a ajouté la propriété GlowEffect.Color qui peut être utilisée pour récupérer la couleur de l’effet de lueur.

L’extrait suivant utilise la propriété GlowEffect.Color.

Consultez l’article détaillé sur Lecture de la couleur de la lueur de la forme

C#

 // Read the source excel file

var book = new Workbook(dir + "sample.xlsx");

// Access first worksheet

var sheet = book.Worksheets[0];

// Access the first shape

var shape = sheet.Shapes[0];

// Read the glow effect color

var glow = shape.Glow;

var color = glow.Color;

Ajout des propriétés PageSetup.PaperWidth & PaperHeight

Aspose.Cells 17.1.0 a exposé les propriétés PaperWidth & PaperHeight pour la classe PageSetup. Les propriétés PageSetup.PaperWidth & PageSetup.PaperHeight sont de type double représentant la largeur et la hauteur du papier en pouces tout en considérant l’orientation de la page.

Consultez l’article détaillé sur Récupération de la taille du papier de la feuille de calcul

Ajout de la propriété WorkbookSettings.CheckCustomNumberFormat

Aspose.Cells 17.1.0 a ajouté la propriété CheckCustomNumberFormat à la classe WorkbookSettings. CheckCustomNumberFormat est utile pour vérifier si la propriété Style.Custom a été correctement définie ou non. Si la propriété Style.Custom a été définie de manière incorrecte, c’est-à-dire si la valeur ne correspond pas à un motif valide, alors les API Aspose.Cells lèveront une CellsException avec le message approprié.

Consultez l’article détaillé sur Vérification du format personnalisé

C#

 // Create an instance of Workbook

var book = new Workbook();

// Set CheckCustomNumberFormat property to true

book.Settings.CheckCustomNumberFormat = true;

// Access first worksheet

var sheet = book.Worksheets[0];

// Access a cell

var cell = sheet.Cells["B5"];

// Insert a value to the cell

cell.PutValue(2347);

// Access cell's style

Style style = cell.GetStyle();



// Set Custom property to an invalid pattern

style.Custom = "ggg @ fff";

// Set the modified style to the cell

cell.SetStyle(style);

Ajout du champ DisplayUnitType.Percentage

Aspose.Cells 17.1.0 a également exposé le champ Percentage dans l’énumération DisplayUnitType. Le champ DisplayUnitType.Percentage indique que les valeurs sur le graphique seront divisées par 0.01.

APIs supprimées

Option m_LoadDataFilterOptions de l’instance supprimée

Cette version a supprimé la variable d’instance m_LoadDataFilterOptions. Il est conseillé d’utiliser la propriété LoadFilter.LoadDataFilterOptions à la place.