Cambios en la API pública en Aspose.Cells 16.10.0

Este documento describe los cambios en la API de Aspose.Cells desde la versión 9.0.0 hasta la 16.10.0 que pueden ser de interés para los desarrolladores de módulos/aplicaciones. Incluye no solo nuevos y actualizados métodos públicos, clases añadidas y eliminadas, sino también una descripción de cualquier cambio en el comportamiento detrás de escena en Aspose.Cells.

APIs Añadidas

Soporte para efectos de reflexión

Aspose.Cells 16.10.0 ha expuesto la clase ReflectionEffect junto con la propiedad Shape.Reflection para controlar los efectos de reflexión de un objeto Shape. La clase ReflectionEffect tiene las siguientes propiedades.

ReflectionEffect.Blur: Obtiene/establece el radio de desenfoque en unidades de puntos.
ReflectionEffect.Direction: Obtiene/establece la dirección de la rampa de degradado alfa en relación con la forma misma.
ReflectionEffect.Distance: Obtiene/establece la distancia de la reflexión en unidades de puntos.
ReflectionEffect.FadeDirection: Obtiene/establece la dirección para desplazar la reflexión.
ReflectionEffect.RotWithShape: Obtiene/establece si la reflexión debe rotar con la forma.
ReflectionEffect.Size: Obtiene/establece la posición final (a lo largo de la rampa de degradado alfa) del valor alfa final en unidades de porcentaje.
ReflectionEffect.Transparency: Obtiene/establece el grado de transparencia inicial de la reflexión como un valor de 0.0 (opaco) a 1.0 (transparente).
ReflectionEffect.Type: Obtiene/establece el efecto de reflexión preestablecido.

Aquí hay un escenario simple de uso de la propiedad Shape.Reflection.

Consulte el artículo detallado sobre Cómo trabajar con efectos de reflexión

 // 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");

Soporte para Efectos de Sombra

Aspose.Cells 16.10.0 ha expuesto la propiedad Shape.ShadowEffect junto con la clase ShadowEffect que, en conjunto, permite establecer el efecto de sombra en un objeto Shape. La clase ShadowEffect tiene las siguientes propiedades.

ShadowEffect.Angle: Obtiene/establece el ángulo de iluminación que varía de 0 a 359.9 grados.
ShadowEffect.Blur: Obtiene y establece el desenfoque de la sombra que varía de 0 a 100 puntos.
ShadowEffect.Color: Obtiene/establece el color de la sombra.
ShadowEffect.Distance: Obtiene/establece la distancia de la sombra que varía de 0 a 200 puntos.
ShadowEffect.PresetType: Obtiene/establece el tipo de sombra preestablecido de la sombra.
ShadowEffect.Size: Obtiene/establece el tamaño de la sombra que varía de 0 a 2.0. Será carente de sentido en caso de sombra interna.
ShadowEffect.Transparency: Obtiene o establece el grado de transparencia de la sombra que va desde 0.0 (opaco) a 1.0 (transparente).

Aquí hay un escenario de uso simple de la propiedad mencionada anteriormente.

Consulta el artículo detallado en Trabajar con efectos de sombra

 // 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");

Soporte para Efectos de Resplandor

Aspose.Cells 16.10.0 ha expuesto la propiedad Shape.Glow junto con la clase GlowEffect, que en conjunto permiten establecer el efecto de resplandor de un objeto Shape. La clase GlowEffect especifica un efecto de resplandor, en el que se agrega un contorno borroso de color fuera de los bordes del objeto usando las siguientes propiedades.

GlowEffect.Size: Obtiene o establece el radio del resplandor en unidades de puntos.
GlowEffect.Transparency: Obtiene o establece el grado de transparencia del efecto de resplandor que va desde 0.0 (opaco) a 1.0 (transparente).

Aquí hay un escenario de uso simple de la propiedad Shape.Glow.

Consulta el artículo detallado en Trabajar con el efecto de resplandor

 // 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");

Soporte para Formato 3D

Aspose.Cells 16.10.0 ha expuesto la propiedad Shape.ThreeDFormat junto con la clase ThreeDFormat, que juntas se pueden utilizar para controlar el formato 3D del objeto Shape. La clase ThreeDFormat representa el formato tridimensional de una forma y tiene las siguientes propiedades.

ThreeDFormat.BottomBevelHeight: Obtiene o establece la altura del bisel inferior o qué tan lejos se aplica en la forma, en unidades de puntos.
ThreeDFormat.BottomBevelType: Obtiene o establece el tipo de bisel inferior o qué tan lejos se aplica en la forma, en unidades de puntos.
ThreeDFormat.BottomBevelWidth: Obtiene o establece el ancho del bisel inferior o qué tan lejos se aplica en la forma, en unidades de puntos.
ThreeDFormat.ContourColor: Obtiene o establece el color de contorno de una forma.
ThreeDFormat.ContourWidth: Obtiene o establece el ancho del contorno en la forma, en unidades de puntos.
ThreeDFormat.ExtrusionColor: Obtiene el color de extrusión en una forma.
ThreeDFormat.ExtrusionHeight: Obtiene o establece la altura de extrusión aplicada a la forma, en unidades de puntos.
ThreeDFormat.LightAngle: Obtiene/establece el ángulo de las luces de extrusión.
ThreeDFormat.Lighting: Obtiene/establece el tipo de configuración de luces.
ThreeDFormat.LightingDirection: Obtiene/establece la dirección desde la que está orientada la configuración de luces en relación a la escena.
ThreeDFormat.Material: Representa el material preestablecido que se combina con las propiedades de iluminación para dar el aspecto final de una forma.
ThreeDFormat.Perspective: Obtiene/establece el ángulo desde el cual se puede ver un objeto ThreeDFormat.
ThreeDFormat.PresetCameraType: Obtiene/establece la cámara preestablecida para la extrusión.
ThreeDFormat.RotationX: Obtiene/establece la rotación de la forma extruida alrededor del eje X en grados.
ThreeDFormat.RotationY: Obtiene/establece la rotación de la forma extruida alrededor del eje Y en grados.
ThreeDFormat.RotationZ: Obtiene/establece la rotación de la forma extruida alrededor del eje Z en grados.
ThreeDFormat.TopBevelHeight: Obtiene/establece la altura del bisel superior o la distancia hasta la cual se aplica en la forma, en puntos.
ThreeDFormat.TopBevelType: Obtiene/establece el tipo de bisel superior o la distancia hasta la cual se aplica en la forma, en puntos.
ThreeDFormat.TopBevelWidth: Obtiene/establece el ancho del bisel superior o la distancia hasta la cual se aplica en la forma, en puntos.
ThreeDFormat.Z: Define la distancia desde el suelo para la forma 3D.

A continuación se muestra un escenario de uso sencillo de la propiedad Shape.ThreeDFormat.

Consulte el artículo detallado sobre Trabajar con Formato 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");

Soporte para Estilos WordArt en el texto de una forma

Aspose.Cells 16.10.0 ha expuesto los métodos FontSettingCollection.SetWordArtStyle y FontSetting.SetWordArtStyle para establecer el estilo predefinido de WordArt en el texto del objeto Shape.

Aquí hay un escenario de uso simple de los mencionados métodos.

Consulte el artículo detallado sobre Trabajar con Estilos de 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);

Soporte para estilos integrados de WordArt

Aspose.Cells 16.10.0 ha expuesto el método ShapeCollection.AddWordArt junto con la enumeración PresetWordArtStyle para brindar soporte para agregar objetos WordArt preestablecidos desde Excel 2007.

Aquí hay un escenario de uso simple del método ShapeCollection.AddWordArt.

Consulte el artículo detallado sobre Agregar WordArt con Estilos Integrados

 // 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");

Método XmlMapCollection.Add agregado

Aspose.Cells ha expuesto el método XmlMapCollection.Add que permite agregar un mapa XML a una hoja de cálculo. Aquí hay un escenario de uso simple del método XmlMapCollection.Add.

Consulte el artículo detallado sobre Agregar un Mapa XML a la Hoja de Cálculo

 // 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");

Método Cells.LinkToXmlMap agregado

Aspose.Cells ha expuesto el método Cells.LinkToXmlMap para vincular las celdas con los elementos del mapa XML.

Aquí hay un escenario de uso simple del método Cells.LinkToXmlMap.

Consulte el artículo detallado sobre Vincular Celdas a Elementos del Mapa 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");

Propiedad Formula de ListColumn agregada

Aspose.Cells 16.10.0 ha expuesto la propiedad ListColumn.Formula para propagar automáticamente la fórmula a las filas recién insertadas.

Aquí hay un escenario de uso simple de la propiedad ListColumn.Formula.

Consulte el artículo detallado sobre Propagar Fórmula Automáticamente en Objeto de Lista

 // 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");

Soporte para Calcular Funciones Personalizadas con GridWeb

Aspose.Cells.GridWeb 16.10.0 ha expuesto la propiedad GridWeb.CustomCalculationEngine junto con la clase GridAbstractCalculationEngine que juntas permiten definir y calcular las funciones personalizadas desde dentro del componente GridWeb.

Aquí hay un escenario de uso simple de los APIs mencionados.

Consulte el artículo detallado sobre Calcular Funciones Personalizadas 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();

}

Cambios en la API pública en Aspose.Cells 9.0.0 Cambios en la API pública en Aspose.Cells 16.11.0