Aspose.Cells 8.5.2のPublic APIの変更

APIの追加

ワークシートをグラフィックコンテキストにレンダリング

このリリースの Aspose.Cells for .NET API は、SheetRender.ToImage メソッドの新しいオーバーロードを公開し、System.Drawing.Graphics クラスのインスタンスを受け入れて グラフィックコンテキストでのレンダリング を可能にしました。新しく追加されたメソッドのシグネチャは次のとおりです。

  1. SheetRender.ToImage(int pageIndex, Graphics g, float x, float y)
  2. SheetRender.ToImage(int pageIndex, Graphics g, float x, float y, float width, float height)

以下はシンプルな使用シナリオです。

C#

 //Create workbook object from source file

Workbook workbook = new Workbook(filePath);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Create empty Bitmap

Bitmap bmp = new Bitmap(800, 800);

//Create Graphics Context

Graphics g = Graphics.FromImage(bmp);

g.Clear(Color.Blue);

//Set one page per sheet to true in image or print options

ImageOrPrintOptions opts = new ImageOrPrintOptions();

opts.OnePagePerSheet = true;

//Render worksheet to graphics context

SheetRender sr = new SheetRender(worksheet, opts);

sr.ToImage(0, g, 0, 0);

//Save the graphics context image in Png format

bmp.Save("test.png", ImageFormat.Png);

PivotTable.GetCellByDisplayName メソッドが追加されました

Aspose.Cells for .NET 8.5.2 は PivotTable.GetCellByDisplayName メソッドを公開し、PivotTable の PivotField 名で Cell オブジェクトを取得 するために使用できます。このメソッドは、PivotField ヘッダーを強調表示または書式設定したいシナリオで有用です。

以下はシンプルな使用シナリオです。

C#

 //Create workbook object from source excel file

Workbook workbook = new Workbook(filePath);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access first pivot table inside the worksheet

PivotTable pivotTable = worksheet.PivotTables[0];

//Access cell by display name of 2nd data field of the pivot table

Cell cell = pivotTable.GetCellByDisplayName(pivotTable.DataFields[1].DisplayName);

//Access cell style and set its fill color and font color

Style style = cell.GetStyle();

style.ForegroundColor = Color.LightBlue;

style.Font.Color = Color.Black;

//Set the style of the cell

pivotTable.Format(cell.Row, cell.Column, style);

//Save workbook

workbook.Save("output.xlsx");

SaveOptions.MergeAreasプロパティを追加

Aspose.Cells for .NET 8.5.2 では、SaveOptions.MergeAreas プロパティが公開され、Boolean 型の値を受け入れるようになりました。デフォルト値は false ですが、true に設定すると、Aspose.Cells for .NET API はファイルを保存する前に個々の CellArea をマージしようとします。

Shape.Geometry.ShapeAdjustValues プロパティが追加されました

v8.5.2 のリリースでは、Aspose.Cells API は Shape.Geometry.ShapeAdjustValues プロパティを公開し、さまざまな形状の調整ポイントを変更するために使用できるようにしました

たとえば、

  1. 丸角長方形には、角を変更するための調整があります
  2. 三角形には、ポイントの位置を変更するための調整があります
  3. 台形には、上部の幅を変更するための調整があります
  4. 矢印には、ヘッドとテールの形状を変更するための2つの調整があります

以下は最もシンプルな使用シナリオです。

C#

 //Create workbook object from source excel file

Workbook workbook = new Workbook(filePath);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access first three shapes of the worksheet

Shape shape1 = worksheet.Shapes[0];

Shape shape2 = worksheet.Shapes[1];

Shape shape3 = worksheet.Shapes[2];

//Change the adjustment values of the shapes

shape1.Geometry.ShapeAdjustValues[0].Value = 0.5d;

shape2.Geometry.ShapeAdjustValues[0].Value = 0.8d;

shape3.Geometry.ShapeAdjustValues[0].Value = 0.5d;

//Save the workbook

workbook.Save("output.xls);

列挙型 ConsolidationFunction.DistinctCount が追加されました

Aspose.Cells for .NET 8.5.2 は ConsolidationFunction.DistinctCount フィールドを公開し、PivotTable の DataField に 重複のないカウントの結合関数を適用 するために使用できます。

GridDesktop のイベントハンドリングの改善

この Aspose.Cells.GridDesktop のリリースでは、4 つの新しいイベントが公開されました。これらのイベントの 2 つは、GridDesktop でスプレッドシートファイルをロードする異なる状態でトリガーされ、残りの 2 つは数式の計算時にトリガーされます。

以下のようにイベントがリストされています。

  1. GridDesktop.BeforeLoadFile
  2. GridDesktop.FinishLoadFile
  3. GridDesktop.BeforeCalculate
  4. GridDesktop.FinishCalculate