Público API Cambios en Aspose.Cells 8.8.1
API 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 se puede usar para especificar el tipo de datos que se debe cargar al crear el libro de trabajo a partir de un archivo de plantilla. Filtrar los datos cargados puede mejorar el rendimiento para propósitos especiales, especialmente cuando se usan las API de LightCells.
La enumeración LoadDataFilterOptions proporciona las siguientes selecciones.
- ALL para cargar todo desde la hoja de cálculo.
- NONE para cargar nada desde la hoja de cálculo.
- CELL_BLANK carga las celdas cuyos valores están en blanco.
- CELL_BOOL carga celdas cuyos valores son booleanos.
- CELL_DATA carga datos de celdas, incluidos valores, fórmulas y formato.
- CELL_ERROR carga celdas cuyos valores son erróneos.
- CELL_NUMERIC 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 solo carga reglas de formato condicional.
- DATA_VALIDATION solo carga reglas de validación de datos.
- DOCUMENT_PROPERTIES carga solo las propiedades del documento.
- FORMULA carga fórmulas que incluyen nombres definidos.
- MERGED_AREA carga solo celdas combinadas.
- PIVOT_TABLE carga tablas dinámicas.
- CONFIGURACIÓN carga solo la configuración del libro y la hoja de trabajo.
- SHAPE carga solo formas.
- STYLE carga el formato de las celdas.
- TABLE carga tablas de Excel/Lista de objetos.
El siguiente es el 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 Aspose.Cells ya han brindado la posibilidad de representar gráficos en PDF al usar el método Chart.toPdf. Con este lanzamiento, el API ha expuesto otra versión sobrecargada de dicho método que podría aceptar una instancia de OutputStream, lo que permite a los usuarios guardar el PDF del gráfico en una instancia de ByteArrayOutputStream.
El siguiente es el 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);
Se agregó 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);
Se agregó la propiedad Shape.TextBody
Esta versión de Aspose.Cells for Java API ha expuesto Shape.TextBody para manipular los aspectos del texto en formas. El siguiente fragmento usa dicha propiedad para establecer el efecto de sombra del texto en un cuadro de texto.
Java
//Crear una instancia de Workbook
Libro de trabajo libro = nuevo libro de trabajo ();
// Acceder a la primera hoja de trabajo del Libro de trabajo
hoja de trabajo = book.getWorksheets().get(0);
//Añadir un TextBox a la ShapeCollection
índice int = hoja.getTextBoxes().add(2, 2, 100, 400);
TextBox textBox = hoja.getTextBoxes().get(index);
//Establecer el texto del cuadro de texto
textBox.setText("Este texto tiene la siguiente configuración.\n\nEfectos de texto > Sombra > Compensación inferior");
//Establecer efecto de sombra para el texto
para (int i = 0; i< textBox.getTextBody().getCount(); i++)
{
textBox.getTextBody().get(i).getShapeFont().getFillFormat().getShadowEffect().setPresetType(PresetShadowType.OFFSET_BOTTOM);
}
Se agregó el método Worksheet.calculateFormula (fórmula de cadena, Opciones de cálculo)
Aspose.Cells for Java 8.8.1 ha expuesto otra sobrecarga para el método Worksheet.calculateFormula que brinda la capacidad de calcular una fórmula determinada directamente con opciones personalizadas.
Se agregó el método GridCell.createValidation
Aspose.Cells.GridWeb ha brindado la capacidad de agregar directamente la regla de validación a una sola celda mientras se usa el método GridCell.createValidation. Dicho método requiere 2 parámetros. El primero es de tipo GridValidationType que determina el tipo de validación, mientras que el segundo parámetro (isRequied) es de tipo booleano.
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);
Se agregó el método GridCell.removeValidation
Aspose.Cells.GridWeb también ha brindado la capacidad de eliminar la regla de validación de datos de GridCell mientras se usa el método GridCell.removeValidation.
API obsoletas
Propiedad Shape.TextFrame obsoleta
Se recomienda utilizar la propiedad Shape.TextBody.TextAlignment en su lugar.