Aspose.Cells 8.5.2のPublic APIの変更
APIの追加
ワークシートをグラフィックコンテキストにレンダリング
このリリースの Aspose.Cells for .NET API は、SheetRender.ToImage メソッドの新しいオーバーロードを公開し、System.Drawing.Graphics クラスのインスタンスを受け入れて グラフィックコンテキストでのレンダリング を可能にしました。新しく追加されたメソッドのシグネチャは次のとおりです。
- SheetRender.ToImage(int pageIndex, Graphics g, float x, float y)
- 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 プロパティを公開し、さまざまな形状の調整ポイントを変更するために使用できるようにしました。
たとえば、
- 丸角長方形には、角を変更するための調整があります
- 三角形には、ポイントの位置を変更するための調整があります
- 台形には、上部の幅を変更するための調整があります
- 矢印には、ヘッドとテールの形状を変更するための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 つは数式の計算時にトリガーされます。
以下のようにイベントがリストされています。
- GridDesktop.BeforeLoadFile
- GridDesktop.FinishLoadFile
- GridDesktop.BeforeCalculate
- GridDesktop.FinishCalculate