Pubblico API Modifiche Aspose.Cells 8.5.0

Questo documento descrive le modifiche allo Aspose.Cells API dalla versione 8.4.2 alla 8.5.0 che potrebbero interessare gli sviluppatori di moduli/applicazioni. Include non solo metodi pubblici nuovi e aggiornati,classi aggiunte ecc., ma anche una descrizione di eventuali cambiamenti nel comportamento dietro le quinte in Aspose.Cells.

API aggiunte

Modificati i parametri ICustomFunction.CalculateCustomFunction

Se un parametro per la funzione personalizzata è il riferimento di cella, nella vecchia versione Aspose.Cells le API utilizzavano per convertire il riferimento di cella in un valore di cella o in un array di oggetti di tutti i valori di cella nell’area di riferimento. Tuttavia, per molte funzioni e utenti non è richiesto l’array dei valori di cella per tutte le celle nell’area di riferimento, hanno solo bisogno di una singola cella corrispondente alla posizione della formula, oppure hanno solo bisogno del riferimento stesso invece del valore della cella o dell’array di valori . Per alcune situazioni, il recupero di tutti i valori delle celle ha persino aumentato il rischio di errore di riferimento circolare.

Per supportare questo tipo di requisito, Aspose.Cells for Java 8.5.0 ha modificato il valore del parametro in “paramsList” per l’area di riferimento. A partire dalla versione 8.5.0, API inserisce semplicemente l’oggetto ReferredArea in “paramsList” quando il parametro corrispondente è un riferimento o il suo risultato calcolato è un riferimento. Se hai bisogno del riferimento stesso, puoi utilizzare direttamente la ReferredArea. Se è necessario ottenere un singolo valore di cella dal riferimento corrispondente alla posizione della formula, è possibile utilizzare il metodo ReferredArea.getValue(rowOffset, int colOffset). Se hai bisogno di un array di valori di cella per l’intera area, puoi utilizzare il metodo ReferredArea.getValues.

Ora che Aspose.Cells for Java 8.5.0 fornisce la ReferredArea in “paramsList”, la ReferredAreaCollection in “contextObjects” non sarà più necessaria (nelle vecchie versioni non poteva sempre fornire una mappa uno-a-uno ai parametri della funzione personalizzata), quindi questa versione l’ha rimossa anche da “contextObjects” ora.

Questa modifica richiede alcune modifiche al codice dell’implementazione per ICustomFunction quando sono necessari il valore/i valori del parametro di riferimento.

Vecchia implementazione

 public object CalculateCustomFunction(string functionName, ArrayList paramsList, ArrayList contextObjects)

{

    ...

    object o = paramsList[i];

    if (o is Array)

    {

        ...

    }

    else if...

    ...

}

Nuova implementazione

 public object CalculateCustomFunction(string functionName, ArrayList paramsList, ArrayList contextObjects)

{

    ...

    object o = paramsList[i];

    if(o is ReferredArea) //fetch data from reference

    {

        ReferredArea ra = (ReferredArea)o;

        if(ra.IsArea)

        {

            o = ra.getValues();

        }

        else

        {

            o = ra.getValue(0, 0);

        }

    }

    if (o is Array)

    {

        ...

    }

    else if...

    ...

}

Class CalculationOptions aggiunto

Aspose.Cells for Java 8.5.0 ha esposto la classe CalculationOptions per aggiungere maggiore flessibilità ed estensibilità al motore di calcolo delle formule. La classe appena aggiunta ha le seguenti proprietà.

CalculationOptions.CalcStackSize: specifica la dimensione dello stack per il calcolo delle celle in modo ricorsivo. -1 specifica che il calcolo utilizzerà WorkbookSettings.CalcStackSize della cartella di lavoro corrispondente.
CalculationOptions.CustomFunction: estende il motore di calcolo delle formule con una formula personalizzata.
CalculationOptions.IgnoreError: il valore di tipo booleano indica se gli errori devono essere nascosti durante il calcolo delle formule, dove gli errori potrebbero essere dovuti alla funzione non supportata, al collegamento esterno o altro.
CalculationOptions.PrecisionStrategy: valore di tipo CalculationPrecisionStrategy che specifica la strategia per l’elaborazione della precisione del calcolo.

Calcolo dell’enumerazioneStrategia di precisione Aggiunta

Aspose.Cells for Java 8.5.0 ha esposto l’enumerazione CalculationPrecisionStrategy per aggiungere maggiore flessibilità al motore di calcolo delle formule per ottenere i risultati desiderati. Questa enumerazione definisce la gestione della precisione del calcolo. A causa del problema di precisione dell’aritmetica in virgola mobile IEEE 754, alcune formule apparentemente semplici potrebbero non essere calcolate per fornire i risultati previsti, pertanto l’ultima build API ha esposto i seguenti campi per ottenere i risultati desiderati in base alla selezione.

CalculationPrecisionStrategy.DECIMAL: utilizza decimal come operando ove possibile ed è molto inefficiente per considerazioni sulle prestazioni.
CalculationPrecisionStrategy.ROUND: arrotonda i risultati del calcolo in base alla cifra significativa.
CalculationPrecisionStrategy.NONE: Nessuna strategia viene applicata pertanto durante il calcolo il motore utilizza il valore double originale come operando e restituisce direttamente il risultato. Questa opzione è la più efficiente ed è applicabile nella maggior parte dei casi.

Metodi Aggiunto per utilizzare CalculationOptions

Con il rilascio di v8.5.0, Aspose.Cells API ha aggiunto versioni di sovraccarico del metodocalcFormula come elencato di seguito.

Workbook.calculateFormula(OpzioniCalcolo)
Worksheet.calculateFormula(Opzioni CalcoloOpzioni, booleano ricorsivo)
Cell.calculate(Opzioni di calcolo)

Campo di enumerazione PasteType.ROW_HEIGHTS Aggiunto

Aspose.Cells Le API hanno fornito PasteType.ROW_Campo di enumerazione HEIGHTS allo scopo di copiare le altezze delle righe durante la copia degli intervalli. Dopo aver impostato la proprietà PasteOptions.PasteType su ((PasteType.ROW_HEIGHTS}} le altezze di tutte le righe all’interno dell’intervallo di origine verranno copiate nell’intervallo di destinazione.

Java

 //Create workbook object

Workbook workbook = new Workbook();

//Source worksheet

Worksheet srcSheet = workbook.getWorksheets().get(0);

//Add destination worksheet

Worksheet dstSheet = workbook.getWorksheets().add("Destination Sheet");

//Set the row height of the 4th row

//This row height will be copied to destination range

srcSheet.getCells().setRowHeight(3, 50);

//Create source range to be copied

Range srcRange = srcSheet.getCells().createRange("A1:D10");

//Create destination range in destination worksheet

Range dstRange = dstSheet.getCells().createRange("A1:D10");

//PasteOptions, we want to copy row heights of source range to destination range

PasteOptions opts = new PasteOptions();

opts.setPasteType(PasteType.ROW_HEIGHTS);

//Copy source range to destination range with paste options

dstRange.copy(srcRange, opts);

//Write informative message in cell D4 of destination worksheet

dstSheet.getCells().get("D4").putValue("Row heights of source range copied to destination range");

//Save the workbook in xlsx format

workbook.save("output.xlsx", SaveFormat.XLSX);

Proprietà SheetRender.PageScale aggiunto

Quando si imposta il ridimensionamento dell’impostazione di pagina utilizzandoAdatta a n pagine di larghezza per m di altezza opzione, Microsoft Excel calcola il fattore di scala Imposta pagina. Lo stesso può essere ottenuto utilizzando la proprietà SheetRender.PageScale esposta da Aspose.Cells for Java 8.5.0. Questa proprietà restituisce un valore double che può essere convertito in valore percentuale. Ad esempio, se restituisce 0,507968245, significa che il fattore di scala è del 51%.

Java

 //Create workbook object

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.getWorksheets().get(0);

//Put some data in these cells

worksheet.getCells().get("A4").putValue("Test");

worksheet.getCells().get("S4").putValue("Test");

//Set paper size

worksheet.getPageSetup().setPaperSize(PaperSizeType.PAPER_A_4);

//Set fit to pages wide as 1

worksheet.getPageSetup().setFitToPagesWide(1);

//Calculate page scale via sheet render

SheetRender sr = new SheetRender(worksheet, new ImageOrPrintOptions());

//Write the page scale value

System.out.println(sr.getPageScale());

Enumerazione CellValueFormatStrategy aggiunta

Aspose.Cells for Java 8.5.0 ha aggiunto una nuova enumerazione CellValueFormatStrategy per gestire le situazioni in cui i valori delle celle devono essere estratti con o senza formattazione applicata. L’enumerazione CellValueFormatStrategy ha i seguenti campi.

CellValueFormatStrategy.CELL_STYLE: formattato solo con il formato originale della cella.
CellValueFormatStrategy.DISPLAY_STYLE: formattato con lo stile visualizzato della cella.
CellValueFormatStrategy.NONE: non formattato.

Metodo Cell.getStringValue aggiunto

Per utilizzare l’enumerazione CellValueFormatStrategy, v8.5.0 ha esposto il metodo Cell.getStringValue che potrebbe accettare un parametro di tipo CellValueFormatStrategy e restituire il valore che dipende dall’opzione specificata.

Il seguente frammento di codice mostra come utilizzare il metodo Cells.getStringValue appena esposto.

Java

 //Create workbook

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.getWorksheets().get(0);

//Access cell A1

Cell cell = worksheet.getCells().get("A1");

//Put value inside the cell

cell.putValue(0.012345);

//Format the cell that it should display 0.01 instead of 0.012345

Style style = cell.getStyle();

style.setNumber(2);

cell.setStyle(style);

//Get string value as Cell Style

String value = cell.getStringValue(CellValueFormatStrategy.CELL_STYLE);

System.out.println(value);

//Get string value without any formatting

value = cell.getStringValue(CellValueFormatStrategy.NONE);

System.out.println(value);

Pubblico API Modifiche Aspose.Cells 8.4.2 Pubblico API Modifiche Aspose.Cells 8.5.1