パブリック API Aspose.Cells 16.10.0 の変更点

このドキュメントでは、モジュール/アプリケーション開発者にとって興味深い、バージョン 9.0.0 から 16.10.0 への Aspose.Cells API への変更について説明します。新規および更新されたパブリックメソッド、追加および削除されたクラスなどだけでなく、Aspose.Cells の舞台裏での動作の変更の説明も含まれています。

追加された API

反射効果のサポート

Aspose.Cells 16.10.0 は、Shape オブジェクトの反射効果を制御するために、Shape.Reflection プロパティとともに ReflectionEffect クラスを公開しました。 ReflectionEffect クラスには、次のプロパティがあります。

ReflectionEffect.Blur: ぼかし半径をポイント単位で取得/設定します。
ReflectionEffect.Direction: シェイプ自体に対するアルファグラディエントランプの方向を取得/設定します。
ReflectionEffect.Distance: 反射の距離をポイント単位で取得/設定します。
ReflectionEffect.FadeDirection: 反射をオフセットする方向を取得または設定します。
ReflectionEffect.RotWithShape: 反射が形状と共に回転するかどうかを取得/設定します。
ReflectionEffect.Size: 終了アルファ値の終了位置 (アルファグラディエントランプに沿った) をパーセンテージ単位で取得/設定します。
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 は、ShadowEffect クラスと共に Shape.ShadowEffect プロパティを公開しました。これにより、Shadow オブジェクトに影の効果を設定できます。 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 オブジェクトのグロー効果を設定できる GlowEffect クラスと共に Shape.Glow プロパティが公開されました。 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 オブジェクトの 3D フォーマットを制御するために一緒に使用できる ThreeDFormat クラスと共に Shape.ThreeDFormat プロパティを公開しました。 ThreeDFormat クラスは、図形の 3 次元の書式設定を表し、次のプロパティがあります。

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

図形のテキストでのワードアートスタイルのサポート

Aspose.Cells 16.10.0 は、プリセットのワードアートスタイルを Shape オブジェクトのテキストに設定するために、FontSettingCollection.SetWordArtStyle および FontSetting.SetWordArtStyle メソッドを公開しました。

前述の方法の簡単な使用シナリオを次に示します。

の詳細記事をチェックワードアートスタイルの操作

 // 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 は、Excel 2007 以降のプリセットワードアートオブジェクトの追加をサポートするために、PresetWordArtStyle 列挙と共に ShapeCollection.AddWordArt メソッドを公開しました。

ここでは、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 は、セルを XML マップ要素にリンクするために Cells.LinkToXmlMap メソッドを公開しました。

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 の変更点