Modifiche all API pubblica in Aspose.Cells 16.10.0

Questo documento descrive le modifiche all’API di Aspose.Cells dalla versione 9.0.0 a 16.10.0 che potrebbero interessare agli sviluppatori di moduli/applicazioni. Include non solo nuovi e aggiornati metodi pubblici, classi aggiunte e rimosse ecc., ma anche una descrizione di eventuali modifiche nel comportamento del dietro le quinte in Aspose.Cells.

API aggiunte

Supporto agli effetti di riflessione

Aspose.Cells 16.10.0 ha esposto la classe ReflectionEffect insieme alla proprietà Shape.Reflection per controllare gli effetti di riflessione di un oggetto Shape. La classe ReflectionEffect ha le seguenti proprietà.

ReflectionEffect.Blur: Ottiene/imposta il raggio di sfocatura in unità di punti.
ReflectionEffect.Direction: Ottiene/imposta la direzione della rampa del gradiente alfa rispetto alla forma stessa.
ReflectionEffect.Distance: Ottiene/imposta la distanza della riflessione in unità di punti.
ReflectionEffect.FadeDirection: Ottiene/imposta la direzione per spostare la riflessione.
ReflectionEffect.RotWithShape: Ottiene/imposta se la riflessione deve ruotare con la forma.
ReflectionEffect.Size: Ottiene/imposta la posizione finale (lungo la rampa del gradiente alfa) del valore finale alfa in percentuale.
ReflectionEffect.Transparency: Ottiene/imposta il grado di trasparenza iniziale della riflessione come valore da 0,0 (opaco) a 1,0 (trasparente).
ReflectionEffect.Type: Ottiene/imposta l’effetto di riflessione preimpostato.

Ecco un semplice scenario di utilizzo della proprietà Shape.Reflection.

Verifica l’articolo dettagliato su Lavorare con gli Effetti di Riflessione

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of ReflectionEffect from the Shape object

var reflection = shape.Reflection;

// Set its Blur, Size, Transparency and Distance properties

reflection.Blur = 30;

reflection.Size = 90;

reflection.Transparency = 0.5;

reflection.Distance = 80;

// Save the result in XLSX format

book.Save("output.xlsx");

Supporto agli effetti d’ombra

Aspose.Cells 16.10.0 ha esposto la proprietà Shape.ShadowEffect insieme alla classe ShadowEffect che permette di impostare l’effetto d’ombra su un oggetto Shape. La classe ShadowEffect ha le seguenti proprietà.

ShadowEffect.Angle: Ottiene/imposta l’angolo di illuminazione che va da 0 a 359,9 gradi.
ShadowEffect.Blur: Ottiene e imposta la sfocatura dell’ombra che va da 0 a 100 punti.
ShadowEffect.Color: Ottiene/imposta il colore dell’ombra.
ShadowEffect.Distance: Ottiene/imposta la distanza dell’ombra compresa tra 0 e 200 punti.
ShadowEffect.PresetType: Ottiene/imposta il tipo di ombra predefinito dell’ombra.
ShadowEffect.Size: Ottiene/imposta le dimensioni dell’ombra comprese tra 0 e 2.0. Sarà insignificante in caso di ombra interna.
ShadowEffect.Transparency: Ottiene/imposta il grado di trasparenza dell’ombra compreso tra 0.0 (opaco) e 1.0 (trasparente).

Ecco un semplice scenario di utilizzo della proprietà sopra citata.

Consulta l’articolo dettagliato su Lavorare con gli Effetti di Ombreggiatura

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of ShadowEffect from the Shape object

var shadow = shape.ShadowEffect;

// Set its Angle, Blur, Size, Transparency and Distance properties

shadow.Angle = 150;

shadow.Blur = 30;

shadow.Size = 90;

shadow.Transparency = 0.5;

shadow.Distance = 80;

// Save the result in XLSX format

book.Save("output.xlsx");

Supporto per gli effetti luminosi

Aspose.Cells 16.10.0 ha esposto la proprietà Shape.Glow insieme alla classe GlowEffect che permette di impostare l’effetto di bagliore di un oggetto Shape. La classe GlowEffect specifica un effetto di bagliore, in cui un contorno sfocato del colore è aggiunto all’esterno dei bordi dell’oggetto utilizzando le seguenti proprietà.

GlowEffect.Size: Ottiene/imposta il raggio del bagliore in unità di punti.
GlowEffect.Transparency: Ottiene/imposta il grado di trasparenza dell’effetto di bagliore compreso tra 0.0 (opaco) e 1.0 (trasparente).

Ecco un semplice scenario di utilizzo della proprietà Shape.Glow.

Controlla l’articolo dettagliato su Lavorare con l’effetto bagliore

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of GlowEffect from the Shape object

var glow = shape.Glow;

// Set its Size & Transparency properties

glow.Size = 90;

glow.Transparency = 0.5;

// Save the result in XLSX format

book.Save("output.xlsx");

Supporto per il formato 3D

Aspose.Cells 16.10.0 ha esposto la proprietà Shape.ThreeDFormat insieme alla classe ThreeDFormat che insieme possono essere utilizzate per controllare la formattazione 3D dell’oggetto Shape. La classe ThreeDFormat rappresenta la formattazione tridimensionale di una forma e ha le seguenti proprietà.

ThreeDFormat.BottomBevelHeight: Ottiene/imposta l’altezza della bisellatura inferiore o quanto è profonda nella forma, in unità di punti.
ThreeDFormat.BottomBevelType: Ottiene/imposta il tipo di bisellatura inferiore o quanto è profonda nella forma, in unità di punti.
ThreeDFormat.BottomBevelWidth: Ottiene/imposta la larghezza della bisellatura inferiore o quanto è profonda nella forma, in unità di punti.
ThreeDFormat.ContourColor: Ottiene/imposta il colore del contorno di una forma.
ThreeDFormat.ContourWidth: Ottiene/imposta la larghezza del contorno sulla forma, in unità di punti.
ThreeDFormat.ExtrusionColor: Ottiene il colore dell’estrusione su una forma.
ThreeDFormat.ExtrusionHeight: Ottiene/imposta l’altezza dell’estrusione applicata alla forma, in unità di punti.
ThreeDFormat.LightAngle: Ottiene/imposta l’angolo delle luci di estrusione.
ThreeDFormat.Lighting: Ottiene/imposta il tipo di illuminazione.
ThreeDFormat.LightingDirection: Ottiene/imposta la direzione da cui è orientata la fonte di luce rispetto alla scena.
ThreeDFormat.Material: Rappresenta il materiale preimpostato combinato con le proprietà di illuminazione per dare il look finale di una forma.
ThreeDFormat.Perspective: Ottiene/imposta l’angolazione con cui un oggetto ThreeDFormat può essere visualizzato.
ThreeDFormat.PresetCameraType: Ottiene/imposta la fotocamera preimpostata per l’estrusione.
ThreeDFormat.RotationX: Ottiene/imposta la rotazione della forma estrusa attorno all’asse X, in unità di gradi.
ThreeDFormat.RotationY: Ottiene/imposta la rotazione della forma estrusa attorno all’asse Y, in unità di gradi.
ThreeDFormat.RotationZ: Ottiene/imposta la rotazione della forma estrusa attorno all’asse Z, in unità di gradi.
ThreeDFormat.TopBevelHeight: Ottiene/imposta l’altezza del bordo superiore o quanto è applicato nella forma, in unità di punti.
ThreeDFormat.TopBevelType: Ottiene/imposta il tipo del bordo superiore o quanto è applicato nella forma, in unità di punti.
ThreeDFormat.TopBevelWidth: Ottiene/imposta la larghezza del bordo superiore o quanto è applicato nella forma, in unità di punti.
ThreeDFormat.Z: Definisce la distanza dal terreno per la forma 3D.

Ecco uno scenario di utilizzo semplice della proprietà Shape.ThreeDFormat.

Controlla l’articolo dettagliato su Lavorare con la formattazione 3D

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of ThreeDFormat from the Shape object

var threeD = shape.ThreeDFormat;

// Set its ContourWidth & ExtrusionHeight properties

threeD.ContourWidth = 15;

threeD.ExtrusionHeight = 30;

// Save the result in XLSX format

book.Save("output.xlsx");

Supporto per gli stili WordArt nel testo di forma

Aspose.Cells 16.10.0 ha esposto i metodi FontSettingCollection.SetWordArtStyle & FontSetting.SetWordArtStyle per impostare lo stile WordArt preimpostato sul testo dell’oggetto Shape.

Ecco uno scenario di utilizzo semplice dei metodi menzionati in precedenza.

Controlla l’articolo dettagliato su Lavorare con gli stili WordArt

 // Create workbook object

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Create a TextBox with some text

var textBox = sheet.Shapes.AddTextBox(0, 0, 0, 0, 100, 700);

textBox.Text = "Aspose File Format APIs";

textBox.Font.Size = 44;

// Set preset WordArt style to the text of the shape

FontSetting fntSetting = textBox.GetCharacters()[0] as FontSetting;

fntSetting.SetWordArtStyle(PresetWordArtStyle.WordArtStyle3);

Supporto per gli stili incorporati di WordArt

Aspose.Cells 16.10.0 ha esposto il metodo ShapeCollection.AddWordArt insieme all’enumerazione PresetWordArtStyle per fornire il supporto per aggiungere oggetti WordArt predefiniti sin da Excel 2007.

Ecco un semplice scenario di utilizzo del metodo ShapeCollection.AddWordArt.

Controlla l’articolo dettagliato su Aggiungere WordArt con stili incorporati

 // Create an instance of Workbook

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access ShapeCollection of first worksheet

var shapes = sheet.Shapes;

// Add WordArt with built-in styles

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle1, "Aspose File Format APIs", 00, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle2, "Aspose File Format APIs", 10, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle3, "Aspose File Format APIs", 20, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle4, "Aspose File Format APIs", 30, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle5, "Aspose File Format APIs", 40, 0, 0, 0, 100, 800);

// Save the result in XLSX format

book.Save("output.xlsx");

Aggiunto il metodo XmlMapCollection.Add

Aspose.Cells ha esposto il metodo XmlMapCollection.Add che consente di aggiungere una mappa XML a un foglio di calcolo. Ecco un semplice scenario di utilizzo del metodo XmlMapCollection.Add.

Controlla l’articolo dettagliato su Aggiungere mappa XML a un foglio di calcolo

 // Create an instance of Workbook

var book = new Workbook();

// Add xml map from the sample.xml to the workbook

book.Worksheets.XmlMaps.Add("sample.xml");

Aggiunto il metodo Cells.LinkToXmlMap

Aspose.Cells ha esposto il metodo Cells.LinkToXmlMap per collegare le celle agli elementi della mappa XML.

Ecco un semplice scenario di utilizzo del metodo Cells.LinkToXmlMap.

Consulta l’articolo dettagliato su Collega celle agli elementi della mappa XML

 // Load a sample spreadsheet in an instance of Workbook

var book = new Workbook("sample.xlsx");

// Access the XML Map from the spreadsheet

var map = book.Worksheets.XmlMaps[0];

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Map FIELD1 and FIELD2 to cell A1 and B2

sheet.Cells.LinkToXmlMap(map.Name, 0, 0, "/root/row/FIELD1");

sheet.Cells.LinkToXmlMap(map.Name, 1, 1, "/root/row/FIELD2");

// Map FIELD4 and FIELD5 to cell C3 and D4

sheet.Cells.LinkToXmlMap(map.Name, 2, 2, "/root/row/FIELD4");

sheet.Cells.LinkToXmlMap(map.Name, 3, 3, "/root/row/FIELD5");

// Map FIELD7 and FIELD8 to cell E5 and F6

sheet.Cells.LinkToXmlMap(map.Name, 4, 4, "/root/row/FIELD7");

sheet.Cells.LinkToXmlMap(map.Name, 5, 5, "/root/row/FIELD8");

Aggiunta la proprietà Formula di ListColumn

Aspose.Cells 16.10.0 ha esposto la proprietà Formula di ListColumn per propagare automaticamente la formula alle righe appena inserite.

Ecco un semplice scenario di utilizzo della proprietà Formula di ListColumn.

Consulta l’articolo dettagliato su Propagare automaticamente la formula nell’oggetto Elenco

 // Create an instance of Workbook

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Add column headings in cell A1 and B1

sheet.Cells[0, 0].PutValue("Column A");

sheet.Cells[0, 1].PutValue("Column B");

// Add list object, set its name and style

var listObject = sheet.ListObjects[sheet.ListObjects.Add(0, 0, 1, sheet.Cells.MaxColumn, true)];

listObject.TableStyleType = TableStyleType.TableStyleMedium2;

listObject.DisplayName = "Table";

// Set the formula of second column so that it could automatically propagate to new rows while entering data

listObject.ListColumns[1].Formula = "=[Column A] + 1";

// Save the result in XLSX format

book.Save("output.xlsx");

Supporto per il calcolo delle funzioni personalizzate con GridWeb

Aspose.Cells.GridWeb 16.10.0 ha esposto la proprietà GridWeb.CustomCalculationEngine insieme alla classe GridAbstractCalculationEngine che consentono di definire e calcolare le funzioni personalizzate all’interno del componente GridWeb.

Ecco un semplice scenario di utilizzo delle API sopra menzionate.

Consulta l’articolo dettagliato su Calcolare le funzioni personalizzate con GridWeb

 private class GridWebCustomCalculationEngine : GridAbstractCalculationEngine

{

    public override void Calculate(GridCalculationData data)

    {

        //  Calculate MYTESTFUNC() with your own logic.

        //For example, you can multiply MYTESTFUNC() parameter with 2 so

        // MYTESTFUNC(3.0) will return 6

        // MYTESTFUNC(4.0) will return 8

        // MYTESTFUNC(5.0) will return 10

        if ("MYTESTFUNC".Equals(data.FunctionName.ToUpper()))

        {

            data.CalculatedValue = (decimal)(2.0 * (double)data.GetParamValue(0));

        }

    }

}


if (Page.IsPostBack == false && GridWeb1.IsPostBack == false)

{

    // Assign your own custom calculation engine to GridWeb

    GridWeb1.CustomCalculationEngine = new GridWebCustomCalculationEngine();

    // Access the active worksheet and add your custom function in cell B3

    GridWorksheet sheet = GridWeb1.ActiveSheet;

    GridCell cell = sheet.Cells["B3"];

    cell.Formula = "=MYTESTFUNC(9.0)";

    // Calculate the GridWeb formula

    GridWeb1.CalculateFormula();

}

Modifiche dell API pubblica in Aspose.Cells 9.0.0 Modifiche all API pubblica in Aspose.Cells 16.11.0