Público API Cambios en Aspose.Cells 8.7.0
API añadidas
Soporte para PDF Optimización
Las API Aspose.Cells ya brindan la función de convertir hojas de cálculo a PDF. Con esta versión de API, los usuarios ahora puedenoptimizar el tamaño resultante PDFtambién. Aspose.Cells for Java 8.7.0 ha expuesto la propiedad PdfSaveOptions.OptimizationType junto con la enumeración PdfOptimizationType para facilitar a los usuarios elegir el algoritmo de optimización deseado al exportar hojas de cálculo al formato PDF. Hay 2 valores posibles para la propiedad PdfSaveOptions.OptimizationType como se detalla a continuación.
- PdfOptimizationType.MINIMUM_SIZE: la calidad se ve comprometida por el tamaño del archivo resultante.
- PdfOptimizationType.STANDARD: la calidad no se ve comprometida, por lo que el tamaño del archivo resultante será grande.
El siguiente es el escenario de uso 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);
Detección de proyecto VBA firmado digitalmente
La propiedad VbaProject.isSigned recientemente expuesta se puede usar paradetectar si el proyecto de VBA en un libro de trabajo está firmado digitalmente. La propiedad VbaProject.isSigned es de tipo booleano, que devuelve verdadero si el proyecto de VBA está firmado digitalmente y viceversa.
El siguiente es el escenario de uso 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étodo Protection.verifyPassword agregado
Aspose.Cells Las API han mejorado la clase de protección mediante la introducción del método de verificación de contraseña que permite especificar una contraseña como una instancia de String yverifica si se ha utilizado la misma contraseña para proteger la hoja de trabajo. El método Protection.verifyPassword devuelve verdadero si la contraseña especificada coincide con la contraseña utilizada para proteger la hoja de cálculo dada y falso si la contraseña especificada no coincide. El siguiente fragmento de código utiliza el método Protection.verifyPassword junto con el campo Protection.isProtectedWithPassword para detectar la protección con contraseña y verifica la contraseña.
El siguiente es el escenario de uso 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");
}
}
Se agregó Property Protection.isProtectedWithPassword
Esta versión de Aspose.Cells for Java también ha expuesto el campo Protection.isProtectedWithPassword que puede ser útil endetectar si una hoja de trabajo está protegida con contraseña o no.
El siguiente es el escenario de uso 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");
}
Propiedad ColorScale.Is3ColorScale agregado
Aspose.Cells for Java 8.7.0 ha expuesto la propiedad ColorScale.Is3ColorScale que se puede utilizar paracrear formato condicional de escala de 2 colores. Dicha propiedad es de tipo booleano con valor predeterminado de verdadero, lo que significa que el formato condicional será de escala de 3 colores de forma predeterminada. Sin embargo, cambiar la propiedad ColorScale.Is3ColorScale a false generará un formato condicional de escala de 2 colores.
El siguiente es el escenario de uso 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
Propiedad TxtLoadOptions.HasFormula Agregada
Aspose.Cells for Java 8.7.0 ha proporcionado soporte paraidentifique y analice las fórmulas mientras carga archivos CSV/TXT con datos simples delimitados. La propiedad TxtLoadOptions.HasFormula recién expuesta cuando se establece en verdadero dirige el API para analizar las fórmulas del archivo delimitado de entrada y establecerlas en celdas relevantes sin requerir ningún procesamiento adicional.
El siguiente es el escenario de uso 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);
Propiedad DataLabels.ResizeShapeToFitText agregado
Otra característica útil que ha expuesto Aspose.Cells for Java 8.7.0 es la propiedad DataLabels.ResizeShapeToFitText que puede habilitar lacambiar el tamaño de la forma para que se ajuste al textocaracterística de la aplicación Excel para las etiquetas de datos del gráfico.
El siguiente es el escenario de uso 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 eliminadas
Propiedad Workbook.SaveOptions Eliminado
La propiedad Workbook.SaveOptions se marcó como obsoleta hace algún tiempo. Con esta versión, se ha eliminado por completo del público API, por lo que se recomienda utilizar el método Workbook.save(Stream, SaveOptions) o Workbook.save(string, SaveOptions) como alternativa.