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.

  1. TUTTO per caricare tutto dal foglio di calcolo.
  2. NULL per caricare nulla dal foglio di calcolo.
  3. CELL_BLANK carica le celle il cui valore è vuoto.
  4. CELL_BOOL carica celle il cui valore è Booleano.
  5. CELL_DATA carica dati delle celle inclusi valori, formule e formattazioni.
  6. CELL_ERROR carica celle il cui valore è un errore.
  7. CELL_NUMERIC carica celle il cui valore è numerico (inclusa Data e Ora).
  8. CELL_STRING carica celle il cui valore è testo/stringa.
  9. CELL_VALUE carica solo i valori delle celle (tutti i tipi).
  10. CHART carica solo grafici.
  11. CONDITIONAL_FORMATTING carica solo regole di formattazione condizionale.
  12. DATA_VALIDATION carica solo regole di convalida dei dati.
  13. DOCUMENT_PROPERTIES carica solo proprietà del documento.
  14. FORMULA carica formule inclusi nomi definiti.
  15. MERGED_AREA carica solo celle unite.
  16. PIVOT_TABLE carica Tabelle Pivot.
  17. SETTINGS carica solo impostazioni di Libro & Foglio di lavoro.
  18. SHAPE carica solo forme.
  19. STYLE carica formattazioni delle celle.
  20. 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.