Changements d API public dans Aspose.Cells 16.11.0
APIs ajoutées
Prise en charge des paramètres de globalisation
Aspose.Cells 16.11.0 a exposé la classe GlobalizationSettings ainsi que la propriété WorkbookSettings.GlobalizationSettings afin d’obliger les API Aspose.Cells à utiliser des libellés personnalisés pour les sous-totaux. La classe GlobalizationSettings possède les méthodes suivantes qui peuvent être remplacées dans l’implémentation personnalisée pour donner des noms désirés aux libellés Total & Total général.
- GlobalizationSettings.getTotalName : Obtient le nom total de la fonction.
- GlobalizationSettings.getGrandTotalName : Obtient le nom total général de la fonction.
Voici une simple classe personnalisée qui étend la classe GlobalizationSettings et remplace ses méthodes susmentionnées pour renvoyer des libellés personnalisés pour la fonction de consolidation Average.
Java
public class CustomSettings extends GlobalizationSettings
{
public String getTotalName(int functionType)
{
switch (functionType)
{
case ConsolidationFunction.AVERAGE:
return "AVG";
default:
return super.getTotalName(functionType);
}
}
public String getGrandTotalName(int functionType)
{
switch (functionType)
{
case ConsolidationFunction.AVERAGE:
return "GRAND AVG";
default:
return super.getGrandTotalName(functionType);
}
}
}
L’extrait suivant charge une feuille de calcul existante et ajoute le sous-total de type Moyenne sur les données déjà disponibles dans la feuille de calcul. La classe CustomSettings et ses méthodes getTotalName & getGrandTotalName seront appelées lors de l’ajout du sous-total à la feuille de calcul.
Java
//Loads an existing spreadsheet containing some data
Workbook book = new Workbook(dir + "sample.xlsx");
//Assigns the GlobalizationSettings property of the WorkbookSettings class
//to the class created in first step
book.getSettings().setGlobalizationSettings(new CustomSettings());
//Accesses the 1st worksheet from the collection which contains data
//Data resides in the cell range A2:B9
Worksheet sheet = book.getWorksheets().get(0);
//Adds SubTotal of type Average to the worksheet
sheet.getCells().subtotal(CellArea.createCellArea("A2", "B9"), 0, ConsolidationFunction.AVERAGE, new int[] { 0,1 });
//Calculates Formulas
book.calculateFormula();
//Auto fits all columns
sheet.autoFitColumns();
//Saves the workbook on disc
book.save(dir + "output.xlsx");
La classe GlobalizationSettings offre également la méthode getOtherName qui est utile pour obtenir le nom des libellés “Autres” pour les diagrammes circulaires. Voici un scénario d’utilisation simple de la méthode GlobalizationSettings.getOtherName.
Java
public class CustomSettings extends GlobalizationSettings
{
public String getOtherName()
{
String language = Locale.getDefault().getLanguage();
System.out.println(language);
switch (language)
{
case "en":
return "Other";
case "fr":
return "Autre";
case "de":
return "Andere";
//Do other cases
default:
return super.getOtherName();
}
}
}
L’extrait suivant charge une feuille de calcul existante contenant un diagramme circulaire, et rend le diagramme en image en utilisant la classe CustomSettings créée ci-dessus.
Java
//Loads an existing spreadsheet containing a pie chart
Workbook book = new Workbook(dir + "sample.xlsx");
//Assigns the GlobalizationSettings property of the WorkbookSettings class
//to the class created in first step
book.getSettings().setGlobalizationSettings(new CustomSettings());
//Accesses the 1st worksheet from the collection which contains pie chart
Worksheet sheet = book.getWorksheets().get(0);
//Accesses the 1st chart from the collection
Chart chart = sheet.getCharts().get(0);
//Refreshes the chart
chart.calculate();
//Renders the chart to image
chart.toImage(dir + "output.png", new ImageOrPrintOptions());
Classe CellsFactory ajoutée
Aspose.Cells 16.11.0 a exposé la classe CellsFactory qui possède actuellement une méthode, c’est-à-dire, createStyle. La méthode CellsFactory.createStyle peut être utilisée pour créer une instance de la classe Style sans l’ajouter au pool des styles du classeur.
Voici un scénario d’utilisation simple de la méthode CellsFactory.createStyle.
Java
//Initializes the CellsFactory class
CellsFactory factory = new CellsFactory();
//Creates an instance of Style
Style style = factory.createStyle();
Propriété Workbook.AbsolutePath ajoutée
Aspose.Cells 16.11.0 a exposé la propriété Workbook.AbsolutePath qui permet d’obtenir ou de définir le chemin absolu du classeur stocké dans le fichier workbook.xml. Cette propriété est utile lors de la mise à jour des liens externes uniquement.
Méthode GridHyperlinkCollection.getHyperlink ajoutée
Aspose.Cells.GridWeb 16.11.0 a exposé la méthode getHyperlink à la classe GridHyperlinkCollection qui permet d’obtenir l’instance de GridHyperlink en passant soit une instance de GridCell soit une paire d’entiers correspondant aux indices de ligne et de colonne.
Voici un scénario d’utilisation simple de la méthode getHyperlink.
Java
//Gets the active worksheet from the collection
GridWorksheet sheet = gridWeb1.getWorkSheets().get(gridWeb1.getActiveSheetIndex());
//Accesses the GridHyperlinkCollection
GridHyperlinkCollection links = sheet.getHyperlinks();
//Gets hyperlink from cell A1
GridHyperlink link = links.getHyperlink(sheet.getCells().get("A1"));
//Gets hyperlink from cell D1
link = links.getHyperlink(0, 3);
APIs obsolètes
Constructeur de style obsolète
Veuillez utiliser la méthode cellsFactory.createStyle comme alternative.
APIs supprimées
Méthode Cell.getConditionalStyle supprimée
Veuillez utiliser la méthode Cell.getConditionalFormattingResult à la place.
Méthode Cells.getMaxDataRowInColumn(int column) supprimée
Veuillez utiliser la méthode Cells.getLastDataRow(int) comme alternative.
Propriété PageSetup.Draft supprimée
Il est conseillé d’utiliser la propriété PageSetup.PrintDraft à la place.
Propriété AutoFilter.FilterColumnCollection supprimée
Veuillez envisager d’utiliser la propriété AutoFilter.FilterColumns pour atteindre le même objectif.
Propriété TickLabels.Rotation supprimée
Veuillez utiliser la propriété TickLabels.RotationAngle à la place.