Aspose.Cells 16.10.0中的公共API更改

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

添加的 API

反射效果支持

Aspose.Cells 16.10.0已经暴露了ReflectionEffect类以及Shape.Reflection属性，以控制形状对象的反射效果。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 类，它们一起允许在形状对象上设置阴影效果。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 类，它们一起允许设置形状对象的辉光效果。GlowEffect 类指定了辉光效果，通过以下属性进行设置。

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

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

查看有关[工作中的辉光效果（/cells/zh/net/working-with-the-glow-effect-of-shape-or-chart/)的详细文章。

 // 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: 获取/设置形状上轮廓的宽度，单位为磅。
ThreeDFormat.ExtrusionColor: 获取形状上挤出的颜色。
ThreeDFormat.ExtrusionHeight: 获取/设置应用于形状的挤出高度，单位为磅。
ThreeDFormat.LightAngle: 获取/设置挤出光线的角度。
ThreeDFormat.Lighting: 获取/设置灯光类型。
ThreeDFormat.LightingDirection: 获取/设置光源照射的方向与场景的关系。
ThreeDFormat.Material: 代表与灯光属性结合以给出形状最终外观的预设材料。
ThreeDFormat.Perspective: 获取/设置可以查看 ThreeDFormat 对象的角度。
ThreeDFormat.PresetCameraType: 获取/设置挤出预设摄像头。
ThreeDFormat.RotationX: 获取/设置绕X轴旋转的挤出形状的旋转角度，单位为度。
ThreeDFormat.RotationY: 获取/设置绕Y轴旋转的挤出形状的旋转角度，单位为度。
ThreeDFormat.RotationZ: 获取/设置围绕 Z 轴的挤出形状的旋转，单位为度。
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");

支持 Shape 的文本中的 WordArt 样式

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

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

查看有关使用 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);

支持内置 WordArt 样式

Aspose.Cells 16.10.0 现已公开了 ShapeCollection.AddWordArt 方法以及 PresetWordArtStyle 枚举，以便自 Excel 2007 以来提供对预设 WordArt 对象的支持。

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

查看有关添加内置样式的 WordArt的详细文章。

 // 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 现已公开了 XmlMapCollection.Add 方法，允许向电子表格中添加 Xml 映射。以下是 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 方法的简单使用场景。

查看有关将单元格链接到 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();

}

Aspose.Cells 9.0.0 中的公共 API 更改 Aspose.Cells 16.11.0 的公共 API 变更。