Public API Changements dans Aspose.Cells 8.3.2
API ajoutées
Mécanisme pour définir la position absolue de PivotItem
Afin de fournir la fonctionnalitéPositionnement absolu de PivotItem, le Aspose.Cells for Java 8.3.2 a exposé une série de propriétés et une méthode comme indiqué ci-dessous.
- PivotItem.setPosition peut être utilisé pour définir l’index de position dans tous les PivotItems, quel que soit le nœud parent.
- PivotItem.setPositionInSameParentNode peut être utilisé pour définir l’index de position dans les PivotItems sous le même nœud parent.
- La méthode PivotItem.move(int count, bool isSameParent) peut être utilisée pour déplacer l’élément vers le haut ou vers le bas en fonction de la valeur de comptage, où count est le nombre de positions pour déplacer le PivotItem vers le haut ou vers le bas. Si la valeur de comptage est inférieure à zéro, l’élément sera déplacé vers le haut où, comme si la valeur de comptage est supérieure à zéro, le PivotItem se déplacera vers le bas, le paramètre de type booléen isSameParent spécifie si l’opération de déplacement doit être effectuée dans le même nœud parent ou non.
Ligne de signature de classe ajoutée
Aspose.Cells 8.3.2 fournit la prise en charge de la ligne de signature pour imiter la fonctionnalité équivalente de MS Excel. Cette version a exposé la classe SignatureLine et la propriété Picture.SignatureLine à cette fin.
L’exemple de code suivant ajoute une ligne de signature à l’aide de la propriété Picture.SignatureLine au classeur.
Java
//Create workbook object
Workbook workbook = new Workbook();
//Insert picture of your choice
int index = workbook.getWorksheets().get(0).getPictures().add(0, 0, "signature.jpg");
//Access picture and add signature line inside it
Picture pic = workbook.getWorksheets().get(0).getPictures().get(index);
//Create signature line object
SignatureLine s = new SignatureLine();
s.setSigner("John Doe");
s.setTitle("Development Lead");
s.setEmail("john.doe@aspose.com");
//Assign the signature line object to Picture.SignatureLine property
pic.setSignatureLine(s);
Méthode Chart.hasAxis ajouté
Avec la version v8.3.2, le Aspose.Cells API a fourni la méthode Chart.hasAxis(AxisType axisType, bool isPrimary) pour déterminer si le graphique a un axe particulier ou non.
L’exemple de code suivant illustre l’utilisation de la méthode Chart.hasAxis pour déterminer si l’exemple de graphique a un axe principal, secondaire et de valeur.
Java
//Create workbook object
Workbook workbook = new Workbook("source.xlsx");
//Access the first worksheet
Worksheet worksheet = workbook.getWorksheets().get(0);
//Access the chart
Chart chart = worksheet.getCharts().get(0);
//Determine which axis exists in chart
boolean ret = chart.hasAxis(AxisType.CATEGORY, true);
System.out.println("Has Primary Category Axis: " + ret);
ret = chart.hasAxis(AxisType.CATEGORY, false);
System.out.println("Has Secondary Category Axis: " + ret);
ret = chart.hasAxis(AxisType.VALUE, true);
System.out.println("Has Primary Value Axis: " + ret);
ret = chart.hasAxis(AxisType.VALUE, false);
System.out.println("Has Seconary Value Axis: " + ret);
Méthode WorkbookSettings.checkWriteProtectedPassword ajouté
La méthode WorkbookSettings.checkWriteProtectedPassword permet aux développeurs de vérifier si un mot de passe donné pour modifier la feuille de calcul est correct ou non.
Java
//Specify password to open inside the load options
LoadOptions opts = new LoadOptions();
opts.setPassword("1234");
//Open the source Excel file with load options
Workbook workbook = new Workbook("Book1.xlsx", opts);
//Check if 567 is Password to modify
boolean ret = workbook.checkWriteProtectedPassword("567");
System.out.println("Is 567 correct Password to modify: " + ret);
Méthodes de surcharge WorkbookRender.toPrinter & SheetRender.toPrinter ajoutés
Aspose.Cells 8.3.2 a fourni les méthodes WorkbookRender.toPrinter(string printerName, int printPageIndex, int printPageCount) et SheetRender.toPrinter(string printerName, int printPageIndex, int printPageCount) pour imprimer respectivement la plage de pages du classeur et de la feuille de calcul.
L’exemple de code suivant illustre l’utilisation des méthodes susmentionnées pour imprimer les pages 2 à 5 du classeur et de la feuille de calcul.
Java
//Create workbook from source Excel file
Workbook workbook = new Workbook("source.xlsx");
//Print the workbook specifying the range of pages
//Here we are printing pages 2-5
WorkbookRender wr = new WorkbookRender(workbook, new ImageOrPrintOptions());
wr.toPrinter(printerName, 1, 4);
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Print the worksheet specifying the range of pages
//Here we are printing pages 2-5
SheetRender sr = new SheetRender(worksheet, new ImageOrPrintOptions());
sr.toPrinter(printerName, 1, 4);
Méthode Worksheet.refreshPivotTables ajoutée
La méthode nouvellement ajoutée Worksheet.refreshPivotTables permet d’actualiser tous les tableaux croisés dynamiques d’une feuille de calcul donnée en un seul appel.
Java
worksheet.refreshPivotTables();
Méthode Workbook.getNamedStyle ajoutée
Aspose.Cells 8.3.2 a exposé la méthode Workbook.getNamedStyle qui accepte la chaîne comme paramètre et récupère l’objet Style en fonction du paramètre passé.
Méthode Cells.importTwoDimensionArray ajoutée
Aspose.Cells API a rendu possible l’importation de tableaux bidimensionnels dans des cellules de feuille de calcul en exposant la méthode Cells.importTwoDimensionArray(object[,], object[,], int, int, TxtLoadOptions). Ladite méthode importe un tableau de données à deux dimensions dans une feuille de calcul avec des options plus flexibles définies dans TxtLoadOptions.
Propriétés OnePagePerSheet, PageIndex et PageCount ajoutées
Aspose.Cells for Java 8.3.2 a exposé les propriétés OnePagePerSheet, PageIndex et PageCount pour la classe XpsSaveOptions. L’utilisateur peut faire tenir tout le contenu d’une feuille de calcul sur une seule page de XPS à l’aide de la propriété OnePagePerSheet et/ou récupérer le nombre de pages à imprimer à l’aide de la propriété PageCount. La propriété PageIndex obtient/définit l’index de base 0 de la première page à enregistrer.
Propriétés NumberDecimalSeparator & NumberGroupSeparator ajoutées
Aspose.Cells for Java 8.3.2 a introduit les propriétés NumberDecimalSeparator et NumberGroupSeparator qui peuvent obtenir/définir les séparateurs personnalisés utilisés pour formater et analyser les valeurs numériques dans les feuilles de calcul.
L’exemple de code suivant illustre comment spécifier les séparateurs personnalisés à l’aide de Aspose.Cells API. Le code suivant spécifie les séparateurs Decimal et Group personnalisés comme point et espace respectivement.
Java
Workbook workbook = new Workbook();
//Specify custom separators
workbook.getSettings().setNumberDecimalSeparator('.');
workbook.getSettings().setNumberGroupSeparator(' ');
Propriété PdfSaveOptions.setFontSubstitutionCharGranularity ajoutée
Aspose.Cells for Java 8.3.2 a exposé la propriété PdfSaveOptions.setFontSubstitutionCharGranularity afin de résoudre le problème où certains caractères Unicode ne peuvent pas être affichés à l’aide d’une famille de polices spécifique. Lorsque la propriété PdfSaveOptions.setFontSubstitutionCharGranularity est définie sur true, seule la police d’un caractère spécifique qui n’est pas affichable sera remplacée par une police affichable et le reste du mot ou de la phrase doit rester dans la police d’origine.
Java
//Save to PDF after setting PdfSaveOptions.setFontSubstitutionCharGranularity
PdfSaveOptions opts = new PdfSaveOptions();
opts.setFontSubstitutionCharGranularity(true);
API supprimées
Méthodes obsolètes supprimées
Les méthodes suivantes ont été supprimées du Public API.
- Méthodes Workbook.open et Workbook.save.
- Méthode Workbook.setOleSize.
- Méthode Workbook.loadData.
- Méthodes WorkbookDesigner.open et WorkbookDesigner.save.
- Méthode WorksheetCollection.deleteName.
Propriétés obsolètes supprimées
Les propriétés suivantes ont été retirées du public API.
- Propriété Workbook.isProtected.
- Propriété Workbook.Language.
- Propriété Workbook.Region.
- Propriété WorkbookSettings.ReCalcOnOpen.
- Propriété WorkbookSettings.Language.
- Propriété WorkbookSettings.Encoding.
- Propriété WorkbookSettings.ConvertNumericData.
- Propriété WorksheetCollection.HidePivotFieldList.
- Propriété WorksheetCollection.EnableHTTPCompression.
- Propriété WorksheetCollection.isMinimized.
- Propriété WorksheetCollection.isHidden.
- Propriété WorksheetCollection.SheetTabBarWidth.
- Propriété WorksheetCollection.WindowLeft.
- Propriété WorksheetCollection.WindowLeftInch.
- Propriété WorksheetCollection.WindowLeftCM.
- Propriété WorksheetCollection.WindowTop.
- Propriété WorksheetCollection.WindowTopInch.
- Propriété WorksheetCollection.WindowTopCM.
- Propriété WorksheetCollection.WindowWidth.
- Propriété WorksheetCollection.WindowWidthInch.
- Propriété WorksheetCollection.WindowWidthCM.
- Propriété WorksheetCollection.WindowHeight.
- Propriété WorksheetCollection.WindowHeightInch.
- Propriété WorksheetCollection.WindowHeightCM.
- Propriété Worksheet.HPageBreaks.
- Propriété Worksheet.VPageBreaks.
- Propriété HtmlSaveOptions.DisplayHTMLCrossString.
- Propriété HtmlSaveOptions.ExportChartImageFormat.
- Propriété SaveOptions.ExpCellNameToXLSX.
- Propriété SaveOptions.DefaultFont.
- Propriété SaveOptions.Compliance.
- Propriété SaveOptions.PdfBookmark.
- Propriété SaveOptions.PdfImageCompression.
- Propriété TxtSaveOptions.AlwaysQuoted.
API obsolètes
Propriété Workbook.saveOptions Obsolète
Un objet de SaveOptions doit être passé à la méthode Workbook.Save après avoir défini les propriétés SaveOptions appropriées.
Property Workbook.Styles & Class StyleCollection Obsolète
Il est conseillé d’utiliser la méthode Workbook.createStyle pour créer et manipuler le style de l’instance Workbook au lieu de créer un style avec la méthode StyleCollection.add. De plus, la méthode Workbook.getNamedStyle(string) peut être utilisée pour obtenir un style nommé au lieu de StyleCollection.get(string).
Méthode PivotItem.move(int count) Obsolète
Avec la version Aspose.Cells 8.3.2, le API a introduit une autre surcharge de la méthode PivotItem.move qui accepte le paramètre entier pour le nombre et le paramètre booléen pour déplacer un PivotItem dans le nœud parent.