Public API Changements dans Aspose.Cells 8.7.0
API ajoutées
Prise en charge de l’optimisation PDF
Les API Aspose.Cells offrent déjà la possibilité de convertir des feuilles de calcul en PDF. Avec cette version de API, les utilisateurs peuvent désormaisoptimiser la taille PDF résultanteainsi que. Aspose.Cells for Java 8.7.0 a exposé la propriété PdfSaveOptions.OptimizationType avec l’énumération PdfOptimizationType afin de permettre aux utilisateurs de choisir l’algorithme d’optimisation souhaité lors de l’exportation des feuilles de calcul au format PDF. Il existe 2 valeurs possibles pour la propriété PdfSaveOptions.OptimizationType comme détaillé ci-dessous.
- PdfOptimizationType.MINIMUM_SIZE : la qualité est compromise pour la taille du fichier résultant.
- PdfOptimizationType.STANDARD : la qualité n’est pas compromise, la taille du fichier résultant sera donc importante.
Voici le scénario d’utilisation simple.
Java
//Create an instance of PdfSaveOptions
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
//Set the OptimizationType property to desired value
pdfSaveOptions.setOptimizationType(PdfOptimizationType.MINIMUM_SIZE);
//Create an instance of Workbook
//Optionally load an existing spreadsheet
Workbook book = new Workbook(inFilePath);
//Save the spreadsheet in PDF format while passing the instance of PdfSaveOptions
book.save(outFilePath, pdfSaveOptions);
Détection d’un projet VBA signé numériquement
La propriété VbaProject.isSigned nouvellement exposée peut être utilisée pourdétecter si le projet VBA dans un classeur est signé numériquement. La propriété VbaProject.isSigned est de type booléen, qui renvoie true si le projet VBA est signé numériquement et vice versa.
Voici le scénario d’utilisation simple.
Java
//Create an instance of Workbook and load an existing spreadsheet
Workbook book = new Workbook(inFilePath);
//Access the VbaProject from the Workbook
VbaProject vbaProject = book.getVbaProject();
//Check if VbaProject is digitally signed
if (vbaProject.isSigned())
{
System.out.println("VbaProject is digitally signed");
}
else
{
System.out.println("VbaProject is not digitally signed");
}
Méthode Protection.verifyPassword ajoutée
Aspose.Cells Les API ont amélioré la classe Protection en introduisant la méthode verifyPassword qui permet de spécifier un mot de passe en tant qu’instance de String etvérifie si le même mot de passe a été utilisé pour protéger la feuille de calcul. La méthode Protection.verifyPassword renvoie true si le mot de passe spécifié correspond au mot de passe utilisé pour protéger la feuille de calcul donnée, et false si le mot de passe spécifié ne correspond pas. Le morceau de code suivant utilise la méthode Protection.verifyPassword conjointement avec le champ Protection.isProtectedWithPassword pour détecter la protection par mot de passe et vérifie le mot de passe.
Voici le scénario d’utilisation simple.
Java
//Create an instance of Workbook and load a spreadsheet
Workbook book = new Workbook(inFilePath);
//Access the protected Worksheet
Worksheet sheet = book.getWorksheets().get(0);
//Check if Worksheet is password protected
if (sheet.getProtection().isProtectedWithPassword())
{
//Verify the password used to protect the Worksheet
if (sheet.getProtection().verifyPassword("password"))
{
System.out.println("Specified password has matched");
}
else
{
System.out.println("Specified password has not matched");
}
}
Propriété Protection.isProtectedWithPassword ajoutée
Cette version de Aspose.Cells for Java a également exposé le champ Protection.isProtectedWithPassword qui peut être utile dansdétecter si une feuille de travail est protégée par un mot de passe ou non.
Voici le scénario d’utilisation simple.
Java
//Create an instance of Workbook and load an existing spreadsheet
Workbook book = new Workbook(inFilePath);
//Access the desired Worksheet via its index or name
Worksheet sheet = book.getWorksheets().get(0);
//Access Protection module of desired Worksheet
Protection protection = sheet.getProtection();
//Check if Worksheet is password protected
if (protection.isProtectedWithPassword())
{
System.out.println("Worksheet is password protected");
}
else
{
System.out.println("Worksheet is not password protected");
}
Propriété ColorScale.Is3ColorScale ajoutée
Aspose.Cells for Java 8.7.0 a exposé la propriété ColorScale.Is3ColorScale qui peut être utilisée pourcréer un format conditionnel d’échelle à 2 couleurs. Ladite propriété est de type booléen avec la valeur par défaut true, ce qui signifie que le format conditionnel sera de 3-Color Scale par défaut. Toutefois, le fait de définir la propriété ColorScale.Is3ColorScale sur false générera un format conditionnel d’échelle à 2 couleurs.
Voici le scénario d’utilisation simple.
Java
//Create an instance of Workbook
//Optionally load an existing spreadsheet
Workbook book = new Workbook();
//Access the Worksheet to which conditional formatting rule has to be added
Worksheet sheet = book.getWorksheets().get(0);
//Add FormatConditions to the collection
int index = sheet.getConditionalFormattings().add();
//Access newly added formatConditionCollection via its index
FormatConditionCollection formatConditionCollection = sheet.getConditionalFormattings().get(index);
//Create a CellArea on which conditional formatting rule will be applied
CellArea cellArea = CellArea.createCellArea("A1", "A5");
//Add conditional formatted cell range
formatConditionCollection.addArea(cellArea);
//Add format condition of type ColorScale
index = formatConditionCollection.addCondition(FormatConditionType.COLOR_SCALE);
//Access newly added format condition via its index
FormatCondition formatCondition = formatConditionCollection.get(index);
//Set Is3ColorScale to false in order to generate a 2-Color Scale format
formatCondition.getColorScale().setIs3ColorScale(false);
//Set other necessary properties
Propriété TxtLoadOptions.HasFormula ajoutée
Aspose.Cells for Java 8.7.0 a fourni un support pouridentifier et analyser les formules lors du chargement des fichiers CSV/TXT ayant des données simples délimitées. La propriété TxtLoadOptions.HasFormula nouvellement exposée, lorsqu’elle est définie sur true, ordonne au API d’analyser les formules du fichier délimité d’entrée et de les définir sur les cellules pertinentes sans nécessiter de traitement supplémentaire.
Voici le scénario d’utilisation simple.
Java
//Create an instance of TxtLoadOptions
TxtLoadOptions options = new TxtLoadOptions();
//Set HasFormula property to true
options.setHasFormula(true);
//Set the Separator property as desired
options.setSeparator(',');
//Load the CSV/TXT file using the instance of TxtLoadOptions
Workbook book = new Workbook(inFilePath, options);
//Calculate formulas in order to get the calculated values of formula in CSV
book.calculateFormula();
//Write result in any of the supported formats
book.save(outFilePath);
Propriété DataLabels.ResizeShapeToFitText ajoutée
Une autre fonctionnalité utile que Aspose.Cells for Java 8.7.0 a exposée est la propriété DataLabels.ResizeShapeToFitText qui peut activer leredimensionner la forme pour l’adapter au textefonctionnalité de l’application Excel pour les étiquettes de données du graphique.
Voici le scénario d’utilisation simple.
Java
//Create an instance of Workbook containing the Chart
Workbook book = new Workbook(inFilePath);
//Access the Worksheet that contains the Chart
Worksheet sheet = book.getWorksheets().get(0);
//Access the desired Chart via its index or name
Chart chart = sheet.getCharts().get(0);
//Access the DataLabels of desired NSeries
DataLabels labels = chart.getNSeries().get(0).getDataLabels();
//Set ResizeShapeToFitText property to true
labels.setResizeShapeToFitText(true);
//Calculate Chart
chart.calculate();
API supprimées
Propriété Workbook.SaveOptions supprimé
La propriété Workbook.SaveOptions a été marquée comme obsolète il y a quelque temps. Avec cette version, il a été complètement supprimé du public API, il est donc conseillé d’utiliser la méthode Workbook.save(Stream, SaveOptions) ou Workbook.save(string, SaveOptions) comme alternative.