Aspose.Cells for Java でピボットテーブルにスタイルを適用する

はじめに

Aspose.Cells は、ピボットテーブル向けに 2 つの並列なスタイル API を提供しています。これらのどちらを使うかは、ワークブックの読み込み元形式ではなく、保存先のファイル形式によって決まります。.xls ファイルから読み込んだワークブックを .xlsx として再保存する場合、レガシーなスタイル API ではなく、モダンなスタイル API が適用されます。

  • PivotTable.PivotTableStyleType は、組み込みの名前付きスタイル（ライトテーマおよびダークテーマ、Excel 2017 で追加されたスタイルを含む）を選択します。これらのプリセットは読み取り専用です。
  • PivotTable.PivotTableStyleName は、Workbook.getWorksheets().getTableStyles().addPivotTableStyle(...) を通じて独自に定義したカスタムスタイルを選択します。プリセットで提供される色、罫線、フォント以外の変更が必要な場合は、カスタムスタイルが必須となります。 さらに、PivotTable.formatAll(Style) は、単一の Style オブジェクトをピボットのすべてのセルに適用し、上記いずれかのスタイル名 API で設定された内容をすべて上書きするショートカットです。テーマに関係なく統一された外観が必要な場合に便利です。

レガシー XLS のプリセット自動書式を適用する

PivotTable.AutoFormatType は、com.aspose.cells.PivotTableAutoFormatType 列挙の値を受け取ります。利用可能な値は、REPORT_1 から REPORT_10、CLASSIC、および TABLE_1 から TABLE_10 です。 次の例では、新しいワークブックを作成し、Fruit/Year/Amount のサンプルデータを入力し、ピボットテーブルを追加して PivotTableAutoFormatType.REPORT_5 を適用し、結果を .xls として保存します。

import com.aspose.cells.*;
// シナリオ 1: レガシー XLS プリセット自動フォーマットを適用する
// 使用中の API: PivotTable.AutoFormatType
// 対象ファイル形式: .xls (レガシー)
// 完全なサンプルとデータファイルについては、https://github.com/aspose-cells/Aspose.Cells-for-.NET をご参照ください
// 新しいワークブックを作成する
Workbook workbook = new Workbook();
// 最初のワークシートを取得する
Worksheet sheet = workbook.getWorksheets().get(0);
// ヘッダー行 (Fruit、Year、Amount) と、
// grape、blueberry、kiwi、cherry を 2020 年と 2021 年にまたいで
// カバーする 9 つのデータ行を含むソースデータを入力する
sheet.getCells().get(0, 0).putValue("Fruit");
sheet.getCells().get(0, 1).putValue("Year");
sheet.getCells().get(0, 2).putValue("Amount");
sheet.getCells().get(1, 0).putValue("grape");
sheet.getCells().get(1, 1).putValue(2020);
sheet.getCells().get(1, 2).putValue(50);
sheet.getCells().get(2, 0).putValue("blueberry");
sheet.getCells().get(2, 1).putValue(2020);
sheet.getCells().get(2, 2).putValue(30);
sheet.getCells().get(3, 0).putValue("kiwi");
sheet.getCells().get(3, 1).putValue(2020);
sheet.getCells().get(3, 2).putValue(25);
sheet.getCells().get(4, 0).putValue("cherry");
sheet.getCells().get(4, 1).putValue(2020);
sheet.getCells().get(4, 2).putValue(40);
sheet.getCells().get(5, 0).putValue("grape");
sheet.getCells().get(5, 1).putValue(2021);
sheet.getCells().get(5, 2).putValue(60);
sheet.getCells().get(6, 0).putValue("blueberry");
sheet.getCells().get(6, 1).putValue(2021);
sheet.getCells().get(6, 2).putValue(35);
sheet.getCells().get(7, 0).putValue("kiwi");
sheet.getCells().get(7, 1).putValue(2021);
sheet.getCells().get(7, 2).putValue(28);
sheet.getCells().get(8, 0).putValue("cherry");
sheet.getCells().get(8, 1).putValue(2021);
sheet.getCells().get(8, 2).putValue(45);
sheet.getCells().get(9, 0).putValue("grape");
sheet.getCells().get(9, 1).putValue(2020);
sheet.getCells().get(9, 2).putValue(45);
// 送信先セル E3 に「Pivot1」という名前のピボットテーブルをソース範囲 A1:C10 を使用して追加する
int pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = sheet.getPivotTables().get(pivotIndex);
// フィールドを割り当てる: Fruit -> 行、Amount -> データ
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount");
// レガシー XLS プリセット自動フォーマット「Report5」を適用する
// 注意: このプロパティは .xls として保存する場合にのみ有効です。
// .xlsx/.xlsm/.xlsb として保存する場合、Excel は AutoFormatType を無視し、
// PivotTableStyleType / PivotTableStyleName で指定されたものを使用します。
pivotTable.setAutoFormatType(PivotTableAutoFormatType.REPORT_5);
// ワークブックをレガシー .xls 形式で保存する
workbook.save("output.xls");

モダンな名前付きプリセットのピボットテーブルスタイルを適用する

カスタムピボットテーブルスタイルを定義して適用する

組み込みのプリセットは変更できません。色、罫線、フォントを上書きする必要がある場合は、必ずカスタムピボットスタイルを定義する必要があります。ワークフローは次の 3 ステップで構成されます。

  1. Workbook.getWorksheets().getTableStyles().addPivotTableStyle(String name) を呼び出して、ワークブックの TableStyles コレクションにカスタムスタイルを追加します。これは新しく作成されたスタイルのインデックスを返します。
  2. TableStyle.getTableStyleElements().add(TableStyleElementType) を通じて要素（WholeTable や GrandTotalRow など）を追加し、TableStyleElement.setElementStyle(Style) を介して各要素に Style を割り当てることで、スタイルを設定します。
  3. PivotTable.PivotTableStyleName にスタイル名を設定して、カスタムスタイルをピボットに適用します。ここでは PivotTableStyleType を使用しないでください。このプロパティは組み込みプリセットを選択するためのものだからです。

利用可能な TableStyleElementType の値には、WHOLE_TABLE、FIRST_ROW、LAST_ROW、FIRST_COLUMN、LAST_COLUMN、GRAND_TOTAL_ROW、GRAND_TOTAL_COLUMN、PAGE_FIELD_LABELS、PAGE_FIELD_VALUES が含まれます。 次の例では、WholeTable に細い黒色の罫線、GrandTotalRow に太字の赤色のフォントを持つカスタムピボットスタイルを定義し、PivotTableStyleName を介してそれを適用して .xlsx として保存します。

import com.aspose.cells.*;
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
// ソースデータを設定: ヘッダー行 + 9行のデータ (A1:C10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);
worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(900);
// A1:C10をソースとするピボットテーブルをE3に「Pivot1」という名前で追加
int pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year");
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount");
// ステップ1: 新しいカスタムピボットテーブルスタイルを登録し、インデックスを取得
int styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle");
TableStyle tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex);
// ステップ2: WholeTable要素を追加し、4辺すべてに細い黒枠線を適用
int wholeTableElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.WHOLE_TABLE);
TableStyleElement wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex);
Style wholeTableStyle = workbook.createStyle();
BorderCollection borders = wholeTableStyle.getBorders();
Border borderTop = borders.getByBorderType(BorderType.TOP_BORDER);
borderTop.setLineStyle(CellBorderType.THIN);
borderTop.setColor(Color.getBlack());
Border borderBottom = borders.getByBorderType(BorderType.BOTTOM_BORDER);
borderBottom.setLineStyle(CellBorderType.THIN);
borderBottom.setColor(Color.getBlack());
Border borderLeft = borders.getByBorderType(BorderType.LEFT_BORDER);
borderLeft.setLineStyle(CellBorderType.THIN);
borderLeft.setColor(Color.getBlack());
Border borderRight = borders.getByBorderType(BorderType.RIGHT_BORDER);
borderRight.setLineStyle(CellBorderType.THIN);
borderRight.setColor(Color.getBlack());
wholeTableElement.setElementStyle(wholeTableStyle);
// ステップ3: GrandTotalRow要素を追加し、太字の赤色フォントを適用
int grandTotalElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.GRAND_TOTAL_ROW);
TableStyleElement grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex);
Style grandTotalStyle = workbook.createStyle();
grandTotalStyle.getFont().setBold(true);
grandTotalStyle.getFont().setColor(Color.getRed());
grandTotalElement.setElementStyle(grandTotalStyle);
// ステップ4: 名前でカスタムスタイルを適用（組み込みプリセット用のPivotTableStyleTypeではない）
pivotTable.setPivotTableStyleName("CustomPivotStyle");
workbook.save("output.xlsx");

FormatAll を使用してすべてのピボットセルに 1 つのスタイルを適用する

PivotTable.formatAll(Style) は、データ領域、行/列ヘッダー、合計を含むピボットテーブルのすべてのセルに単一の Style オブジェクトを適用するショートカットです。PivotTableStyleType または PivotTableStyleName を介して以前に設定された内容はすべて上書きされます。

次の例では、黄色の単色塗りつぶし、太字の濃紺フォント、すべての辺に細い黒色の罫線を持つ Style を作成し、formatAll で適用して .xlsx として保存します。

import com.aspose.cells.*;
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
// ソースデータを入力: ヘッダー行 (1行目) + 9データ行 (2-10行目)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(5000);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(3000);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(4000);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(2000);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(6000);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(3500);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(4500);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(2500);
worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(5500);
// ピボットテーブルを追加: ソース範囲 A1:C10、配置先セル E3、名前 "Pivot1"
int pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.getPivotTables().get(pivotIndex);
// ピボットフィールドを割り当て: Fruit -> 行エリア、Year -> 列エリア、Amount -> データエリア
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year");
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount");
// ピボットテーブルのすべてのセルに強制適用されるStyleを構築
Style style = workbook.createStyle();
style.setForegroundColor(Color.getYellow());
style.setPattern(BackgroundType.SOLID);
style.getFont().setBold(true);
style.getFont().setColor(Color.getDarkBlue());
style.getBorders().getByBorderType(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN);
style.getBorders().getByBorderType(BorderType.TOP_BORDER).setColor(Color.getBlack());
style.getBorders().getByBorderType(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN);
style.getBorders().getByBorderType(BorderType.BOTTOM_BORDER).setColor(Color.getBlack());
style.getBorders().getByBorderType(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN);
style.getBorders().getByBorderType(BorderType.LEFT_BORDER).setColor(Color.getBlack());
style.getBorders().getByBorderType(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN);
style.getBorders().getByBorderType(BorderType.RIGHT_BORDER).setColor(Color.getBlack());
// FormatAllを適用: この単一のスタイルをピボットテーブルのすべてのセルに強制適用し、
// 以前に設定されたPivotTableStyleType / PivotTableStyleNameを上書きします
pivotTable.formatAll(style);
// ワークブックを最新の.xlsx形式で保存
workbook.save("output.xlsx");

どのスタイル API を使用すべきか?

スタイル API の選択は、保存先のファイル形式によって異なります。下の表をクイックリファレンスとしてご活用ください。

保存先のファイル形式 使用する API メモ
.xls（レガシー） PivotTable.AutoFormatType com.aspose.cells.PivotTableAutoFormatType の値（例: REPORT_1～REPORT_10、CLASSIC、TABLE_1～TABLE_10）。モダン形式で保存する場合は無視されます。
.xlsx / .xlsm / .xlsb（モダン、組み込みスタイル） PivotTable.PivotTableStyleType com.aspose.cells.PivotTableStyleType の値（ライト/ダークテーマ、Excel 2017 で追加されたものを含む）。
.xlsx / .xlsm / .xlsb（モダン、カスタムスタイル） PivotTable.PivotTableStyleName + Worksheets.TableStyles.addPivotTableStyle(...) 組み込みプリセットで足りない場合に使用します。TableStyleElement.setElementStyle(...) を介して設定します。
すべての形式（統一上書き） PivotTable.formatAll(Style) ピボット全体の他のすべてのスタイル設定を上書きするショートカット。
判断に迷った場合は、.xlsx として保存し、組み込みテーマには PivotTableStyleType を、カスタムテーマには PivotTableStyleName を使用してください。
ピボットテーブルに計算フィールドを追加する Aspose.Cells for Java でピボットテーブルの行フィールドと列フィールドを追加する