Aspose.Cells 8.4.2での公開APIの変更

APIの追加

改良されたチャート作成メカニズム

com.aspose.cells.charts.Chartクラスは、setChartDataRangeメソッドを公開し、チャートの作成タスクを容易にしました。setChartDataRangeメソッドは、2つのパラメータを受け入れます。1つ目のパラメータは、データ系列をプロットするためのセル範囲を指定するstring型で、2つ目のパラメータは、プロットの方向(つまり、行または列ごとにチャートのデータ系列をプロットするか)を指定するBoolean型です。

以下のコードスニペットは、少数のコードを使用して列のチャートを作成する方法を示しています。チャートのプロット系列データが同じワークシート上のセルA1からD4にあると仮定しています。

Java

 //Add a new chart of type Column to chart collection

int idx = worksheet.getCharts().add(ChartType.COLUMN, 6, 5, 20, 13);

//Retrieve the newly added chart instance

Chart chart = worksheet.getCharts().get(idx);

//Specify the chart's data series from cell A1 to D4

chart.setChartDataRange("A1:D4", true);

VbaModuleCollection.addメソッドを追加しました

Aspose.Cells for Java 8.4.2では、VbaModuleCollection.addメソッドを公開し、ワークブックのインスタンスに新しいVBAモジュールを追加するために使用できるようにしました。VbaModuleCollection.addメソッドは、ワークシートの型のパラメータを受け入れ、ワークシート固有のモジュールを追加するために使用します。

以下のコードスニペットは、VbaModuleCollection.addメソッドの使用方法を示しています。

Java

 //Create new workbook

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.getWorksheets().get(0);

//Add VBA module

int idx = workbook.getVbaProject().getModules().add(worksheet);

//Access the VBA Module, set its name and code

VbaModule module = workbook.getVbaProject().getModules().get(idx);

module.setName("TestModule");

module.setCodes("Sub ShowMessage()" + "\r\n" +

"    MsgBox \"Welcome to Aspose!\"" + "\r\n" +

"End Sub");

//Save the workbook

workbook.save(output, SaveFormat.XLSM);

Cells.copyColumnsのオーバーロードメソッドを追加しました

Aspose.Cells for Java 8.4.2では、Cells.copyColumnsメソッドのオーバーロードバージョンを公開し、元の列を宛先に繰り返しコピーできるようにしました。新たに公開されたメソッドは、合計5つのパラメータを受け入れます。最初の4つのパラメータは、通常のCells.copyColumnsメソッドと同じです。ただし、最後のint型のパラメータは、元の列を繰り返す宛先の列の数を指定します。

以下のコードスニペットは、新たに公開されたCells.copyColumnsメソッドの使用方法を示しています。

Java

 //Load an existing workbook

Workbook workbook = new Workbook(input);

//Access first worksheet

Worksheet worksheet = workbook.getWorksheets().get(0);

//Access cells of first worksheet

Cells cells = worksheet.getCells();

//Copy the first two columns (A & B) along with formatting

//to columns G, H & I.

//Please note, the columns G & H will be replaced by A & B respectively

//whereas, column I will be replaced by the column A

cells.copyColumns(cells, 0, 2, 6, 3);

//Save the workbook

workbook.save(output);

列挙型フィールドPasteType.DEFAULTおよびPasteType.ALL_EXCEPT_BORDERSを追加しました

v8.4.2のリリースに伴い、Aspose.Cells APIにはPasteType用の2つの新しい列挙型フィールドが追加されました。

  • PasteType.DEFAULT: セルの範囲を貼り付ける際に、Excelの「全て」機能と類似の操作を行います。
  • PasteType.ALL_EXCEPT_BORDERS: セルの範囲を貼り付ける際に、Excelの「罫線を含まない全て」機能と類似の操作を行います。

以下のサンプルコードは、PasteType.DEFAULTフィールドの使用方法を示しています。

Java

 //Load an existing workbook

Workbook workbook = new Workbook(input);

//Access first worksheet

Worksheet worksheet = workbook.getWorksheets().get(0);

//Access cells of first worksheet

Cells cells = worksheet.getCells();

//Create source & destination ranges

Range source = cells.createRange("A1:B6");

Range destination = cells.createRange("D1:E6");

//Create an instance of PasteOptions and set its PasteType property

PasteOptions options = new PasteOptions();

options.setPasteType(PasteType.DEFAULT);

//Copy the source range onto the destination range with everything except column widths

destination.copy(source, options);

//Save the workbook

workbook.save(output);