Cambios en la API Pública en Aspose.Cells 8.8.1
APIs Añadidas
Filtrar los Datos para Cargar
Aspose.Cells for Java 8.8.1 ha expuesto la enumeración LoadDataFilterOptions junto con la propiedad LoadOptions.LoadDataFilterOptions que puede ser utilizada para especificar el tipo de datos que se deben cargar al construir el libro de un archivo de plantilla. Filtrar los datos cargados puede mejorar el rendimiento para propósitos especiales, especialmente al usar las APIs de LightCells.
La enumeración LoadDataFilterOptions proporciona las siguientes selecciones.
- TODO para cargar todo desde la hoja de cálculo.
- NADA para no cargar nada desde la hoja de cálculo.
- CELDA_EN_BLANCO carga las celdas cuyos valores están en blanco.
- CELDA_BOOL carga celdas cuyos valores son booleanos.
- CELDA_DATOS carga los datos de celdas incluyendo valores, fórmulas y formato.
- CELDA_ERROR carga celdas cuyos valores son errores.
- CELDA_NUMÉRICO carga celdas cuyos valores son numéricos (incluyendo Fecha y Hora).
- CELL_STRING carga celdas cuyos valores son texto/cadena.
- CELL_VALUE carga solo valores de celda (todos los tipos).
- CHART carga solo gráficos.
- CONDITIONAL_FORMATTING carga solo reglas de formato condicional.
- DATA_VALIDATION carga solo reglas de validación de datos.
- DOCUMENT_PROPERTIES carga solo propiedades del documento.
- FORMULA carga fórmulas, incluidos nombres definidos.
- MERGED_AREA carga solo celdas fusionadas.
- PIVOT_TABLE carga tablas dinámicas.
- SETTINGS carga solo configuraciones de Libro y Hoja de cálculo.
- SHAPE carga solo formas.
- STYLE carga formato de celdas.
- TABLE carga tablas de Excel/Objetos de lista.
A continuación se muestra un escenario de uso simple.
Java
//Create an instance of LoadOptions & initialize it with type of template to be loaded
LoadOptions options = new LoadOptions(LoadFormat.XLSX);
//Set LoadDataFilterOptions to load only shapes
options.setLoadDataFilterOptions(LoadDataFilterOptions.SHAPE);
//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions
Workbook book = new Workbook(filePath, options);
Convertir directamente el gráfico a PDF
Las API de Aspose.Cells ya han proporcionado la facilidad de renderizar gráficos a PDF mientras se usa el método Chart.toPdf. Con este lanzamiento, la API ha expuesto otra versión sobrecargada de dicho método que podría aceptar una instancia de OutputStream, permitiendo a los usuarios guardar el PDF del gráfico en una instancia de ByteArrayOutputStream.
A continuación se muestra un escenario de uso simple.
Java
//Create an instance of Workbook and load an existing spreadsheet with a chart
Workbook workbook = new Workbook(filePath);
//Access first worksheet containing a chart
Worksheet worksheet = workbook.getWorksheets().get(0);
//Access first chart from the worksheet
Chart chart = worksheet.getCharts().get(0);
//Save the chart to PDF as Stream
ByteArrayOutputStream outStream = new ByteArrayOutputStream();
chart.toPdf(outStream);
Añadida la propiedad WorkbookSettings.PaperSize
Aspose.Cells for Java 8.8.1 ha expuesto la propiedad WorkbookSettings.PaperSize para establecer el tamaño de papel de impresión predeterminado para toda la hoja de cálculo. La propiedad WorkbookSettings.PaperSize acepta un valor de la enumeración PaperSizeType que contiene los tamaños predefinidos para los tipos de papel de impresión más utilizados.
Java
//Create an instance of Workbook
//Optionally load an existing spreadsheet
Workbook book = new Workbook();
//Access WorkbookSettings from the Workbook
WorkbookSettings settings = book.getSettings();
//Set the default printing paper size for the Workbook
settings.setPaperSize(PaperSizeType.PAPER_A_4);
Añadida la propiedad Shape.TextBody
Esta versión de la API Aspose.Cells for Java ha expuesto la propiedad Shape.TextBody para manipular los aspectos del texto en formas. El siguiente fragmento de código utiliza dicha propiedad para establecer el efecto de sombra del texto en un cuadro de texto.
Java
//Create an instance of Workbook
Workbook book = new Workbook();
//Access first worksheet of the Workbook
Worksheet sheet = book.getWorksheets().get(0);
//Add a TextBox to the ShapeCollection
int index = sheet.getTextBoxes().add(2, 2, 100, 400);
TextBox textBox = sheet.getTextBoxes().get(index);
//Set the text of the TextBox
textBox.setText("This text has the following settings.\n\nText Effects > Shadow > Offset Bottom");
//Set shadow effect for text
for (int i = 0; i < textBox.getTextBody().getCount(); i++)
{
textBox.getTextBody().get(i).getShapeFont().getFillFormat().getShadowEffect().setPresetType(PresetShadowType.OFFSET_BOTTOM);
}
Añadido el método Worksheet.calculateFormula(string formula, CalculationOptions opts)
Aspose.Cells for Java 8.8.1 ha expuesto otra sobrecarga para el método Worksheet.calculateFormula que proporciona la capacidad de calcular una fórmula dada directamente con opciones personalizadas.
Añadido el método GridCell.createValidation
Aspose.Cells.GridWeb ha proporcionado la capacidad de agregar directamente la regla de validación a una celda individual mediante el método GridCell.createValidation. Dicho método requiere 2 parámetros. El primero es del tipo GridValidationType que determina el tipo de validación, mientras que el segundo parámetro (isRequied) es del tipo Boolean.
Java
//Access first worksheet
GridWorksheet sheet = gridweb.getWorkSheets().get(0);
//Access cell B3
GridCell cell = sheet.getCells().get("B3");
//Add validation inside the GridCell
//Any value which is not between 20 and 40 will cause error in a GridCell
GridValidation val = cell.createValidation(GridValidationType.WHOLE_NUMBER, true);
val.setFormula1("=20");
val.setFormula2("=40");
val.setOperator(OperatorType.BETWEEN);
val.setShowError(true);
val.setShowInput(true);
Añadido el método GridCell.removeValidation
Aspose.Cells.GridWeb también ha proporcionado la capacidad de eliminar la regla de validación de datos de una GridCell mediante el método GridCell.removeValidation.
APIs obsoletas
Propiedad Shape.TextFrame obsoleta
Se recomienda utilizar la propiedad Shape.TextBody.TextAlignment en su lugar.