Aspose.Cells 17.1.0 の公開API変更
APIの追加
Excel 2016 チャートのサポート
Aspose.CellsのAPIは、ChartType列挙型を拡張していくつかのExcel 2016 チャートのサポートを追加しました。Aspose.Cells17.1.0のリリースと共に、以下の新しいフィールドが追加されています。
- ChartType.BoxWhisker: シリーズは箱ひげとして配置されます。
- ChartType.Funnel: シリーズはファンネルとして配置されます。
- ChartType.ParetoLine: シリーズはパレートラインとして配置されます。
- ChartType.Sunburst: シリーズはサンバーストとして配置されます。
- ChartType.Treemap: シリーズはツリーマップとしてレイアウトされます。
- ChartType.Waterfall: シリーズはウォーターフォールとして配置されます。
- ChartType.Histogram: シリーズはヒストグラムとして配置されます。
LoadFilter.LoadDataFilterOptions プロパティのセッターが追加されました
Aspose.Cells17.1.0では、LoadFilter.LoadDataFilterOptions プロパティのセッターが追加され、m_LoadDataFilterOptions インスタンス変数を置き換えるためにLoadFilterクラスのユーザーは自分の実装でLoadDataFilterOptionsプロパティを変更できます
以下は単純な使用シナリオです。
C#
class CustomFilter : Aspose.Cells.LoadFilter
{
public override void StartSheet(Worksheet sheet)
{
if (sheet.Name == "Sheet1")
{
// Load everything
this.LoadDataFilterOptions = LoadDataFilterOptions.All;
}
else
{
// Load nothing
this.LoadDataFilterOptions = LoadDataFilterOptions.None;
}
}
}
CellsHelper.SignificantDigits プロパティが追加されました。
Aspose.Cells 17.1.0 では，CellsHelper クラスから SignificantDigits プロパティが公開され，スプレッドシート内の数値の有効桁数を取得または設定できます。CellsHelper.SignificantDigits プロパティのデフォルト値は17であり，結果をXLSXファイル形式で保存する場合のみ適用されます。
CellsHelper.SignificantDigits プロパティの使用法をデモンストレーションするシンプルなシナリオです。
C#
// Specify the number of significant digits
CellsHelper.SignificantDigits = 15;
GlowEffect.Color プロパティが追加されました。
Aspose.Cells 17.1.0 に GlowEffect.Color プロパティが追加され，グローエフェクトの色を取得するのに使用できます。
以下のコードは GlowEffect.Color プロパティを使用しています。
C#
// Read the source excel file
var book = new Workbook(dir + "sample.xlsx");
// Access first worksheet
var sheet = book.Worksheets[0];
// Access the first shape
var shape = sheet.Shapes[0];
// Read the glow effect color
var glow = shape.Glow;
var color = glow.Color;
PageSetup.PaperWidth 及び PaperHeight プロパティが追加されました。
Aspose.Cells 17.1.0 では，PageSetup クラスに PaperWidth 及び PaperHeight プロパティが公開されました。PageSetup.PaperWidth 及び PageSetup.PaperHeight プロパティは，インチ単位でペーパーの幅と高さを表す double 型です。
WorkbookSettings.CheckCustomNumberFormat プロパティが追加されました。
Aspose.Cells 17.1.0 に WorkbookSettings クラスに CheckCustomNumberFormat プロパティが追加されました。CheckCustomNumberFormat は Style.Custom プロパティが適切に設定されているかどうかを確認するのに役立ちます。Style.Custom プロパティが適切に設定されていない場合，つまり，値が有効なパターンに対応していないと，Aspose.Cells API は適切なメッセージとともに CellsException をスローします。
C#
// Create an instance of Workbook
var book = new Workbook();
// Set CheckCustomNumberFormat property to true
book.Settings.CheckCustomNumberFormat = true;
// Access first worksheet
var sheet = book.Worksheets[0];
// Access a cell
var cell = sheet.Cells["B5"];
// Insert a value to the cell
cell.PutValue(2347);
// Access cell's style
Style style = cell.GetStyle();
// Set Custom property to an invalid pattern
style.Custom = "ggg @ fff";
// Set the modified style to the cell
cell.SetStyle(style);
DisplayUnitType.Percentageフィールドを追加しました
Aspose.Cells 17.1.0では、DisplayUnitType列挙体にPercentageフィールドも公開されました。DisplayUnitType.Percentageフィールドは、チャート上の値を0.01で除算することを示します。
API が削除されました
Instance Variable m_LoadDataFilterOptions が削除されました。
このリリースでは，m_LoadDataFilterOptions インスタンス変数が削除されました。LoadFilter.LoadDataFilterOptions プロパティを使用することを推奨します。