Pubblico API Modifiche Aspose.Cells 17.1.0

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

API aggiunte

Supporto per i grafici di Excel 2016

Aspose.Cells Le API hanno aggiunto il supporto per alcuni grafici di Excel 2016 migliorando l’enumerazione ChartType. Di seguito sono stati aggiunti nuovi campi con il rilascio di Aspose.Cells 17.1.0.

ChartType.BOX_WHISKER: la serie è strutturata come scatola e baffo.
ChartType.FUNNEL: la serie è strutturata come un imbuto.
ChartType.PARETO_LINE: la serie è strutturata come linee di pareto.
ChartType.SUNBURST: la serie è strutturata come uno sprazzo di sole.
ChartType.TREEMAP: la serie è strutturata come una mappa ad albero.
ChartType.WATERFALL: la serie è strutturata come una cascata.
ChartType.HISTOGRAM: la serie è strutturata come un istogramma.

Controlla l’articolo dettagliato suLettura dei tipi di grafici di Excel 2016

Aggiunto setter per la proprietà LoadFilter.LoadDataFilterOptions

Aspose.Cells 17.1.0 ha aggiunto setter per la proprietà LoadFilter.LoadDataFilterOptions per sostituire la variabile di istanza m_LoadDataFilterOptions. Gli utenti possono modificare la proprietà LoadDataFilterOptions nella propria implementazione della classe LoadFilter per modificare il comportamento del caricamento dei file modello.

Ecco un semplice scenario di utilizzo.

Controlla l’articolo dettagliato suFiltraggio modello personalizzato

Java

 class CustomLoadFilter extends LoadFilter {

	public void startSheet(Worksheet sheet) {

		if (sheet.getName().equals("NoCharts")) {

			//Load everything and filter charts

			this.setLoadDataFilterOptions(LoadDataFilterOptions.ALL& ~LoadDataFilterOptions.CHART);

		}

		if (sheet.getName().equals("NoShapes")) {

			//Load everything and filter shapes

			this.setLoadDataFilterOptions(LoadDataFilterOptions.ALL& ~LoadDataFilterOptions.SHAPE);

		}

		if (sheet.getName().equals("NoConditionalFormatting")) {

			//Load everything and filter conditional formatting

			this.setLoadDataFilterOptions(LoadDataFilterOptions.ALL& ~LoadDataFilterOptions.CONDITIONAL_FORMATTING);

		}

	}

}

Aggiunta proprietà CellsHelper.SignificantDigits

Aspose.Cells 17.1.0 ha esposto la proprietà SignificantDigits della classe CellsHelper che consente di ottenere o impostare il numero di cifre significative per i valori numerici in un foglio di calcolo. Il valore predefinito della proprietà CellsHelper.SignificantDigits è 17 mentre è applicabile solo se il risultato deve essere memorizzato nel formato file XLSX.

Ecco un semplice scenario per dimostrare l’utilizzo della proprietà CellsHelper.SignificantDigits.

Controlla l’articolo dettagliato suImpostazione del numero di cifre significative

Java

 //Specify the number of significant digits

CellsHelper.setSignificantDigits(15);

Aggiunta proprietà GlowEffect.Color

Aspose.Cells 17.1.0 ha aggiunto la proprietà GlowEffect.Color che può essere utilizzata per recuperare il colore dell’effetto bagliore.

Il frammento di codice seguente utilizza la proprietà GlowEffect.Color.

Controlla l’articolo dettagliato suLettura del colore del bagliore della forma

Java

 //Read the source Excel file

Workbook book = new Workbook(dir + "sample.xlsx");

//Access first worksheet

Worksheet sheet = book.getWorksheets().get(0);

//Access the first shape

Shape shape = sheet.getShapes().get(0);

//Read the glow effect color

GlowEffect glow = shape.getGlow();

CellsColor color = glow.getColor();

Aggiunte le proprietà PageSetup.PaperWidth e PaperHeight

Aspose.Cells 17.1.0 ha esposto le proprietà PaperWidth e PaperHeight per la classe PageSetup. Le proprietà PageSetup.PaperWidth e PageSetup.PaperHeight sono di tipo double e rappresentano la larghezza e l’altezza della carta nell’unità di pollici tenendo conto dell’orientamento della pagina.

Controlla l’articolo dettagliato suRecupero del formato carta del foglio di lavoro

Aggiunta proprietà WorkbookSettings.CheckCustomNumberFormat

Aspose.Cells 17.1.0 ha aggiunto la proprietà CheckCustomNumberFormat alla classe WorkbookSettings. Il CheckCustomNumberFormat è utile per verificare se la proprietà Style.Custom è stata impostata correttamente o meno. Nel caso in cui la proprietà Style.Custom sia stata impostata in modo errato, ovvero; il valore non corrisponde a un modello valido, le API Aspose.Cells genereranno CellsException con il messaggio appropriato.

Controlla l’articolo dettagliato suVerifica del formato personalizzato

Java

 //Create an instance of Workbook

Workbook book = new Workbook();

//Set CheckCustomNumberFormat property to true

book.getSettings().setCheckCustomNumberFormat(true);

//Access first worksheet

Worksheet sheet = book.getWorksheets().get(0);

//Access a cell

Cell cell = sheet.getCells().get("B5");

//Insert a value to the cell

cell.putValue(2347);

//Access cell's style

Style style = cell.getStyle();



//Set Custom property to an invalid pattern

style.setCustom("ggg @ fff");

//Set the modified style to the cell

cell.setStyle(style);

Aggiunto campo DisplayUnitType.PERCENTAGE

Aspose.Cells 17.1.0 ha anche esposto il campo PERCENTAGE all’enumerazione DisplayUnitType. Il campo DisplayUnitType.PERCENTAGE indica che i valori sul grafico devono essere divisi per 0,01.

API rimosse

Variabile di istanza m_LoadDataFilterOptions Rimosso

Questa versione ha rimosso la variabile di istanza m_LoadDataFilterOptions. Si consiglia invece di utilizzare la proprietà LoadFilter.LoadDataFilterOptions.

Pubblico API Modifiche Aspose.Cells 16.12.0