Aspose.Cells 16.11.0 での Public API 変更

APIの追加

グローバリゼーション設定のサポート

Aspose.Cells 16.11.0 は、Subtotals にカスタム ラベルを使用するように Aspose.Cells API を強制するために GlobalizationSettings クラスと WorkbookSettings.GlobalizationSettings プロパティを公開しました。GlobalizationSettings クラスには、カスタム実装で望ましい名前を指定するためにオーバーライドできる次のメソッドがあります TotalGrand Total

  • GlobalizationSettings.GetTotalName:関数の合計名を取得します。
  • GlobalizationSettings.GetGrandTotalName:関数のグランド合計名を取得します。

GlobalizationSettings クラスを拡張し、前述のメソッドをオーバーライドしてコンソリデーション関数 Average のカスタム ラベルを返す単純なカスタムクラスは次のとおりです。

C#

 class CustomSettings : GlobalizationSettings

{

    public override string GetTotalName(ConsolidationFunction functionType)

    {

        switch (functionType)

        {

            case ConsolidationFunction.Average:

                return "AVG";

            default:

                return base.GetTotalName(functionType);

        }

    }

    public override string GetGrandTotalName(ConsolidationFunction functionType)

    {

        switch (functionType)

        {

            case ConsolidationFunction.Average:

                return "GRD AVG";

            default:

                return base.GetGrandTotalName(functionType);

        }

    }

}

次のスニペットは、Pieチャートの「その他」のラベルの名前を取得する便利なGlobalizationSettings.GetOtherNameメソッドの使用シナリオです。

C#

 // Loads an existing spreadsheet containing some data

Workbook book = new Workbook(dir + "sample.xlsx");

// Assigns the GlobalizationSettings property of the WorkbookSettings class

// to the class created in first step

book.Settings.GlobalizationSettings = new Cells.CustomSettings();

// Accesses the 1st worksheet from the collection which contains data

// Data resides in the cell range A2:B9

Worksheet sheet = book.Worksheets[0];

// Adds SubTotal of type Average to the worksheet

sheet.Cells.Subtotal(CellArea.CreateCellArea("A2", "B9"), 0, ConsolidationFunction.Average, new int[] { 0,1 });

// Calculates Formulas

book.CalculateFormula();

// Auto fits all columns

sheet.AutoFitColumns();

// Saves the workbook on disc

book.Save(dir + "output.xlsx");

次のスニペットは、上記で作成したCustomSettingsクラスを使用して、ピースプレッドシートをロードし、チャートを画像にレンダリングするシナリオです。

C#

 class CustomSettings : GlobalizationSettings

{

    public override string GetOtherName()

    {

        int lcid = System.Globalization.CultureInfo.CurrentCulture.LCID;

        switch (lcid)

        {

            case 1033:

                return "Other";

            case 1036:

                return "Autre";

            case 1031:

                return "Andere";

            //Do other case

            default:

                return base.GetOtherName();

        }

    }

}

次のコード片は、Pie チャートを含む既存のスプレッドシートを読み込み、上記で作成した CustomSettings クラスを利用しながらチャートを画像にレンダリングします。

C#

 // Loads an existing spreadsheet containing a pie chart

Workbook book = new Workbook(dir + "sample.xlsx");

// Assigns the GlobalizationSettings property of the WorkbookSettings class

// to the class created in first step

book.Settings.GlobalizationSettings = new Cells.CustomSettings();

// Accesses the 1st worksheet from the collection which contains pie chart

Worksheet sheet = book.Worksheets[0];

// Accesses the 1st chart from the collection

Chart chart = sheet.Charts[0];

// Refreshes the chart

chart.Calculate();

// Renders the chart to image

chart.ToImage(dir + "output.png", new ImageOrPrintOptions());

CellsFactory クラスを追加しました

Aspose.Cells 16.11.0では、CellsFactoryクラスが公開され、現在はCreateStyleという1つのメソッドがあります。CellsFactory.CreateStyleメソッドを使用して、ワークブックスタイルのプールに追加することなくStyleクラスのインスタンスを作成できます。

CellsFactory.CreateStyleメソッドの単純な使用シナリオは以下の通りです。

C#

 // Initializes the CellsFactory class

CellsFactory factory = new CellsFactory();

// Creates an instance of Style

Style style = factory.CreateStyle();

Workbook.AbsolutePath プロパティを追加しました

Aspose.Cells 16.11.0 は、workbook.xml ファイルに保存された絶対ワークブック パスを取得または設定するための Workbook.AbsolutePath プロパティを公開しました。このプロパティは、外部リンクの更新時に便利です。

Aspose.Cells.GridWeb 16.11.0では、GridHyperlinkCollectionクラスにGetHyperlinkメソッドが公開されました。

GridHyperlinkCollectionクラスのGetHyperlinkメソッドの使用シナリオの簡単な例です。

GetHyperlinkメソッドの単純な使用シナリオは以下の通りです。

C#

 // Gets the active worksheet from the collection

GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accesses the GridHyperlinkCollection

GridHyperlinkCollection links = sheet.Hyperlinks;

// Gets hyperlink from cell A1

GridHyperlink link = links.GetHyperlink(sheet.Cells["A1"]);

// Gets hyperlink from cell D1

link = links.GetHyperlink(0, 3);

非推奨API

廃止された Style コンストラクタ

代わりに、cellsFactory.CreateStyleメソッドを使用してください。

削除されたAPI

Deleted Cell.GetConditionalStyle Method

代わりに、Cell.GetConditionalFormattingResultメソッドを使用してください。

削除されたCells.MaxDataRowInColumn(int column) Method

代わりに、Cells.GetLastDataRow(int)メソッドを使用してください。

PageSetup.Draft プロパティが削除されました

代わりに PageSetup.PrintDraft プロパティを使用することをお勧めします

AutoFilter.FilterColumnCollection プロパティが削除されました

同じ目標を達成するためには AutoFilter.FilterColumns プロパティを考慮してください

TickLabels.Rotation プロパティが削除されました

代わりに TickLabels.RotationAngle プロパティを使用してください