公共 API Aspose.Cells 16.10.0 的变化

本文档描述了 Aspose.Cells API 从版本 9.0.0 到 16.10.0 的变化，模块/应用程序开发人员可能会感兴趣。它不仅包括新的和更新的公共方法、添加和删除的类等，还包括对 Aspose.Cells 中幕后行为的任何更改的描述。

添加的 API

支持反射效果

Aspose.Cells 16.10.0 公开了 ReflectionEffect 类和 Shape.Reflection 属性，以控制 Shape 对象的反射效果。 ReflectionEffect 类具有以下属性。

ReflectionEffect.Blur：获取/设置以点为单位的模糊半径。
ReflectionEffect.Direction：获取/设置 alpha 渐变渐变相对于形状本身的方向。
ReflectionEffect.Distance：获取/设置以点为单位的反射距离。
ReflectionEffect.FadeDirection：获取/设置偏移反射的方向。
ReflectionEffect.RotWithShape：获取/设置反射是否应随形状旋转。
ReflectionEffect.Size：获取/设置以百分比为单位的结束 alpha 值的结束位置（沿着 alpha 渐变斜坡）。
ReflectionEffect.Transparency：获取/设置起始反射透明度的程度，值为从 0.0（不透明）到 1.0（透明）的值。
ReflectionEffect.Type：获取/设置预设反射效果。

这是 Shape.Reflection 属性的简单使用场景。

查看详细文章使用反射效果

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

支持阴影效果

Aspose.Cells 16.10.0 公开了 Shape.ShadowEffect 属性和 ShadowEffect 类，它们一起允许在 Shape 对象上设置阴影效果。 ShadowEffect 类具有以下属性。

ShadowEffect.Angle：获取/设置光照角度，范围为0到359.9度。
ShadowEffect.Blur：获取和设置阴影的模糊度，范围为0到100点。
ShadowEffect.Color：获取/设置阴影的颜色。
ShadowEffect.Distance：获取/设置阴影的距离，取值范围为0到200点。
ShadowEffect.PresetType：获取/设置阴影的预设阴影类型。
ShadowEffect.Size：获取/设置阴影的大小，范围从0到2.0。如果有内阴影，它将毫无意义。
ShadowEffect.Transparency：获取/设置阴影的透明度，范围从0.0（不透明）到1.0（透明）。

这是上述属性的简单使用场景。

查看详细文章使用阴影效果

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

支持发光效果

Aspose.Cells 16.10.0 公开了 Shape.Glow 属性和 GlowEffect 类，它们一起允许设置 Shape 对象的发光效果。 GlowEffect 类指定发光效果，其中使用以下属性在对象边缘外添加颜色模糊轮廓。

GlowEffect.Size：获取/设置以点为单位的发光半径。
GlowEffect.Transparency：获取/设置发光效果的透明度，范围从0.0（不透明）到1.0（透明）。

这是 Shape.Glow 属性的简单使用场景。

查看详细文章使用发光效果

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

支持 3D 格式

Aspose.Cells 16.10.0 公开了 Shape.ThreeDFormat 属性以及 ThreeDFormat 类，它们一起可用于控制 Shape 对象的 3D 格式设置。 ThreeDFormat 类表示形状的三维格式并具有以下属性。

ThreeDFormat.BottomBevelHeight：获取/设置底部斜面的高度或应用形状的深度，以点为单位。
ThreeDFormat.BottomBevelType：获取/设置底部斜面的类型或应用形状的深度，以点为单位。
ThreeDFormat.BottomBevelWidth：获取/设置底部斜面的宽度或应用形状的深度，以点为单位。
ThreeDFormat.ContourColor：获取/设置形状的轮廓颜色。
ThreeDFormat.ContourWidth：获取/设置形状上的轮廓宽度，以Points为单位。
ThreeDFormat.ExtrusionColor：获取形状上的挤出颜色。
ThreeDFormat.ExtrusionHeight：获取/设置应用于形状的挤出高度，单位为Points。
ThreeDFormat.LightAngle：获取/设置挤出灯的角度。
ThreeDFormat.Lighting：获取/设置光照装置的类型。
ThreeDFormat.LightingDirection：获取/设置灯光装置相对于场景的方向。
ThreeDFormat.Material：表示预设材质，它与照明属性相结合以提供形状的最终外观和感觉。
ThreeDFormat.Perspective：获取/设置可以查看 ThreeDFormat 对象的角度。
ThreeDFormat.PresetCameraType：获取/设置挤压预设相机。
ThreeDFormat.RotationX：获取/设置拉伸形状绕 X 轴的旋转度，单位为 Degrees。
ThreeDFormat.RotationY：获取/设置拉伸形状绕 Y 轴的旋转度，单位为 Degrees。
ThreeDFormat.RotationZ：获取/设置拉伸形状绕 Z 轴的旋转度，单位为 Degrees。
ThreeDFormat.TopBevelHeight：获取/设置顶部斜面的高度或应用到形状中的深度，以点为单位。
ThreeDFormat.TopBevelType：获取/设置顶部斜面的类型或它应用到形状中的程度，以点为单位。
ThreeDFormat.TopBevelWidth：获取/设置顶部斜角的宽度或应用到形状中的距离，以点为单位。
ThreeDFormat.Z：定义 3D 形状与地面的距离。

以下是 Shape.ThreeDFormat 属性的简单使用场景。

查看详细文章使用 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");

支持形状文本中的艺术字样式

Aspose.Cells 16.10.0 公开了 FontSettingCollection.SetWordArtStyle 和 FontSetting.SetWordArtStyle 方法，以便将预设艺术字样式设置为 Shape 对象的文本。

下面是上述方法的简单使用场景。

查看详细文章使用艺术字样式

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

支持艺术字内置样式

Aspose.Cells 16.10.0 公开了 ShapeCollection.AddArt 方法以及 PresetWordArtStyle 枚举，以提供对自 Excel 2007 以来添加预设艺术字对象的支持。

下面是 ShapeCollection.AddWordArt 方法的简单使用场景。

查看详细文章添加具有内置样式的艺术字

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

添加了 XmlMapCollection.Add 方法

Aspose.Cells 公开了允许将 Xml 映射添加到电子表格的 XmlMapCollection.Add 方法。下面是 XmlMapCollection.Add 方法的简单使用场景。

查看详细文章将 XML 映射添加到电子表格

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

添加了 Cells.LinkToXmlMap 方法

Aspose.Cells 现在公开了 Cells.LinkToXmlMap 方法，以便将单元格与 XML 地图元素链接起来。

下面是Cells.LinkToXmlMap方法的简单使用场景。

查看详细文章将 Cells 链接到 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");

添加了 ListColumn.Formula 属性

Aspose.Cells 16.10.0 公开了 ListColumn.Formula 属性，以便自动将公式传播到新插入的行。

这是 ListColumn.Formula 属性的简单使用场景。

查看详细文章在列表对象中自动传播公式

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

支持使用 GridWeb 计算自定义函数

Aspose.Cells.GridWeb 16.10.0 公开了 GridWeb.CustomCalculationEngine 属性以及 GridAbstractCalculationEngine 类，它们一起允许从 GridWeb 组件中定义和计算自定义函数。

下面是上述API的简单使用场景。

查看详细文章使用 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();

}

公共 API Aspose.Cells 9.0.0 的变化公共 API Aspose.Cells 16.11.0 的变化