Cambiamenti nell API pubblica in Aspose.Cells 8.8.1
API aggiunte
Filtrare i dati per il caricamento
Aspose.Cells for Java 8.8.1 ha esposto l’enumerazione LoadDataFilterOptions insieme alla proprietà LoadOptions.LoadDataFilterOptions che può essere utilizzata per specificare il tipo di dati che dovrebbe essere caricato durante la costruzione del foglio di calcolo da un file modello. Filtrare i dati caricati può migliorare le prestazioni per scopi speciali, specialmente quando si utilizzano le API LightCells.
L’enumerazione LoadDataFilterOptions fornisce le seguenti selezioni.
- TUTTO per caricare tutto dal foglio di calcolo.
- NULL per caricare nulla dal foglio di calcolo.
- CELL_BLANK carica le celle il cui valore è vuoto.
- CELL_BOOL carica celle il cui valore è Booleano.
- CELL_DATA carica dati delle celle inclusi valori, formule e formattazioni.
- CELL_ERROR carica celle il cui valore è un errore.
- CELL_NUMERIC carica celle il cui valore è numerico (inclusa Data e Ora).
- CELL_STRING carica celle il cui valore è testo/stringa.
- CELL_VALUE carica solo i valori delle celle (tutti i tipi).
- CHART carica solo grafici.
- CONDITIONAL_FORMATTING carica solo regole di formattazione condizionale.
- DATA_VALIDATION carica solo regole di convalida dei dati.
- DOCUMENT_PROPERTIES carica solo proprietà del documento.
- FORMULA carica formule inclusi nomi definiti.
- MERGED_AREA carica solo celle unite.
- PIVOT_TABLE carica Tabelle Pivot.
- SETTINGS carica solo impostazioni di Libro & Foglio di lavoro.
- SHAPE carica solo forme.
- STYLE carica formattazioni delle celle.
- TABLE carica tabelle di Excel/Elenco Oggetti.
Di seguito è riportato il semplice scenario d’uso.
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);
Convertire direttamente il grafico in PDF
Le API di Aspose.Cells hanno già fornito la possibilità di renderizzare grafici in PDF utilizzando il metodo Chart.toPdf. Con questa release, l’API ha esposto un’altra versione sovraccaricata del suddetto metodo che potrebbe accettare un’istanza di OutputStream, permettendo agli utenti di salvare il PDF del grafico in un’istanza di ByteArrayOutputStream.
Di seguito è riportato il semplice scenario d’uso.
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);
Aggiunta della proprietà WorkbookSettings.PaperSize
Aspose.Cells for Java 8.8.1 ha esposto la proprietà WorkbookSettings.PaperSize per impostare la dimensione predefinita della carta per l’intero foglio elettronico. La proprietà WorkbookSettings.PaperSize accetta un valore dell’enumerazione PaperSizeType che contiene le dimensioni predefinite per la maggior parte dei tipi di carta da stampa più utilizzati.
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);
Aggiunta della proprietà Shape.TextBody
Questa release di Aspose.Cells for Java API ha esposto Shape.TextBody per manipolare gli aspetti del testo in una forma. Il seguente snippet utilizza la suddetta proprietà per impostare l’effetto ombra del testo in una TextBox.
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);
}
Aggiunto metodo Worksheet.calculateFormula(string formula, CalculationOptions opts)
Aspose.Cells for Java 8.8.1 ha esposto un’altra sovraccarica per il metodo Worksheet.calculateFormula che fornisce la possibilità di calcolare una formula data direttamente con opzioni personalizzate.
Aggiunto metodo GridCell.createValidation
Aspose.Cells.GridWeb ha fornito la possibilità di aggiungere direttamente la regola di convalida a una singola cella utilizzando il metodo GridCell.createValidation. Il suddetto metodo richiede 2 parametri. Il primo è di tipo GridValidationType che determina il tipo di convalida, mentre il secondo parametro (isRequied) è di 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);
Aggiunto metodo GridCell.removeValidation
Aspose.Cells.GridWeb ha anche fornito la possibilità di rimuovere la regola di convalida dei dati da una GridCell utilizzando il metodo GridCell.removeValidation.
API deprecate
Proprietà Shape.TextFrame deprecata
Si consiglia di utilizzare la proprietà Shape.TextBody.TextAlignment al suo posto.