Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
PivotTable.formatAll はピボットテーブル全体に単一のスタイルを適用し、親ページで取り上げられています。ラベル、値、合計、またはレポートの特定の領域を区別しません。
実際には、ピボットテーブルの一部だけを強調表示する必要があることが多いです。一般的な対象としては、ある行フィールドに属するラベル、そのフィールドによって生成された値セル、総計行、または最初の 2 行のような任意の矩形があります。
ピボットテーブルのワークシート上のセルに直接スタイルを適用しても同等ではありません。Excel はピボットテーブルの書式設定を普通のセルスタイル レコードではなく、意味的な PivotArea 領域として保存します。ピボット領域の書式はフィールドのラベルやデータ値などの領域に結び付けられ、ピボットテーブルが再計算、更新、または拡張される際に再解決されます。一方、セルに直接書き込まれたスタイルはそのセル位置に属し、ピボットモデルによって追跡されません。
Aspose.Cells は完全な PivotTable.format オーバーロード ファミリーを提供しており、両方の書式設定方法が利用可能です。
format(PivotArea, Style) は、PivotArea.select または PivotArea.selectField で構築された意味的領域にスタイルを結び付けます。format(CellArea, Style) は、ピボットテーブル内のワークシート矩形にスタイルを結び付けます。format(int row, int column, Style) は単一のセルを対象とします。formatAll(Style) はピボットテーブル全体を書式設定します。フィールドやレポートの領域にハイライトを付随させる必要がある場合、意味的領域ワークフローが推奨されます。
PivotArea(pivot_table) を使用して PivotArea を作成します。このオブジェクトは、特定のピボットテーブルに属する意味的領域を表します。PivotArea.select(PivotFieldType axisType, int fieldPosition, PivotTableSelectionType selectionType) を使用して、指定された軸上のゼロベース位置でフィールドを選択します。
PivotTableSelectionType.DATA_AND_LABEL はフィールドのラベルとデータの両方を選択します。PivotTableSelectionType.LABEL_ONLY はフィールドのラベルのみを選択します。PivotTableSelectionType.DATA_ONLY はフィールドのデータセルのみを選択します。PivotArea.selectField(PivotFieldType axisType, String fieldName) を使用してフィールド名で選択します。行フィールドを名前で選択すると、領域はそのフィールドの項目が生成する値セルに解決されます。workbook.createStyle() で Style を作成し、フォント、前景色、単色背景パターンを設定してから、そのスタイルを PivotTable.format(area, style) に渡します。PivotArea のオーバーロードを呼び出すたびに、PivotTable.getPivotFormats() に PivotTableFormat エントリが 1 つ追加されます。PivotTable.calculateData() を呼び出し、スタイルが表示されるようにします。PivotArea.select と PivotTableSelectionType.LABEL_ONLY を使用して Fruit 行ラベルにスタイルを適用し、同じ行フィールドで生成された値セルに PivotArea.selectField でスタイルを適用し、最後にピボットテーブルを再計算して両方のスタイルを描画します。import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import (
Workbook,
Worksheet,
Cells,
Range,
SaveFormat,
Style,
Color,
BackgroundType,
PivotArea,
PivotFieldType,
PivotTableSelectionType,
)
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# Fruit sales data
fruits = ["Apple", "Banana", "Apple", "Banana", "Cherry", "Cherry"]
years = [2024, 2024, 2025, 2025, 2024, 2025]
amounts = [100, 150, 120, 180, 90, 110]
cells.get("A1").putValue("Fruit")
cells.get("B1").putValue("Year")
cells.get("C1").putValue("Amount")
for i in range(len(fruits)):
cells.get(i + 1, 0).putValue(fruits[i])
cells.get(i + 1, 1).putValue(years[i])
cells.get(i + 1, 2).putValue(amounts[i])
# Pivot table with its top-left corner at E3
pivot_table = sheet.getPivotTables().add("=A1:C7", 2, 4)
pivot_table.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivot_table.addFieldToArea(PivotFieldType.DATA, "Amount")
pivot_table.calculateData()
# Bold yellow fill on the row field's label cells
label_style = workbook.createStyle()
label_style.getFont().setBold(True)
label_style.setForegroundColor(Color.getYellow())
label_style.setPattern(BackgroundType.SOLID)
label_area = PivotArea(pivot_table)
label_area.select(PivotFieldType.ROW, 0, PivotTableSelectionType.LABEL_ONLY)
pivot_table.format(label_area, label_style)
# Light green fill on the value cells the row field produces
value_style = workbook.createStyle()
value_style.setForegroundColor(Color.getLightGreen())
value_style.setPattern(BackgroundType.SOLID)
value_area = PivotArea(pivot_table)
value_area.selectField(PivotFieldType.ROW, "Fruit")
pivot_table.format(value_area, value_style)
# Field-anchored formats are painted when the data is calculated
pivot_table.calculateData()
# Label cells E4:E6 are now bold on yellow, value cells F4:F6 are light green
workbook.save("FormatPivotArea.xlsx")
jpype.shutdownJVM()
関心領域が意味的なピボット領域ではなく、単純なワークシート矩形である場合は PivotTable.format(CellArea, Style) を使用します。
CellArea は getStartRow(), getStartColumn(), getEndRow(), getEndColumn() プロパティで記述されます。これらの値はゼロベースのワークシート座標で、終了座標は矩形に含まれる最終行と列を示すため、開始位置から終了位置までのセルを含みます。
フィールドにアンカーされた書式とは異なり、CellArea の書式はセルに即座に適用されます。スタイルを表示させるために PivotTable.calculateData() を再度呼び出す必要はありません。
CellArea 矩形はラベルセルと値セルを同時に含むことがあります。次のセクションでは、Aspose.Cells と Excel がその矩形を内部的にどのように表現しているかを説明します。
以下の例はピボットテーブルの矩形 E4:F5 に斜体の薄い青色スタイルを適用し、再計算せずにワークブックを保存します。
import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import (
Workbook,
Worksheet,
Cells,
Range,
SaveFormat,
Color,
BackgroundType,
CellArea,
PivotFieldType,
)
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
fruits = ["Apple", "Banana", "Apple", "Banana", "Cherry", "Cherry"]
years = [2024, 2024, 2025, 2025, 2024, 2025]
amounts = [100, 150, 120, 180, 90, 110]
cells.get("A1").putValue("Fruit")
cells.get("B1").putValue("Year")
cells.get("C1").putValue("Amount")
for i in range(len(fruits)):
cells.get(i + 1, 0).putValue(fruits[i])
cells.get(i + 1, 1).putValue(years[i])
cells.get(i + 1, 2).putValue(amounts[i])
pivot_table = sheet.getPivotTables().add("=A1:C7", 2, 4)
pivot_table.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivot_table.addFieldToArea(PivotFieldType.DATA, "Amount")
pivot_table.calculateData()
# Highlight the first two fruit rows (the rectangle E4:F5)
highlight_style = workbook.createStyle()
highlight_style.getFont().setItalic(True)
highlight_style.setForegroundColor(Color.fromArgb(0xFF, 0x99, 0xCC, 0xFF))
highlight_style.setPattern(BackgroundType.SOLID)
rectangle = CellArea()
rectangle.StartRow = 3
rectangle.StartColumn = 4
rectangle.EndRow = 4
rectangle.EndColumn = 5
pivot_table.format(rectangle, highlight_style)
# E4:F5 is italic on light blue immediately, no recalculation needed
workbook.save("FormatPivotCellArea.xlsx")
jpype.shutdownJVM()
Excel はピボットテーブルの書式設定を通常のワークシートセルスタイル レコードではなく pivotArea レコードとして保存します。同様のモデルが Aspose.Cells でも使用されており、書式設定要求は記録時にピボット領域へ変換されます。
ユーザーが提供する CellArea と内部で保存されるピボット領域の関係は、双方向に多対多です。
CellArea は複数のピボット領域を生成することがあります。矩形がラベルセルと値セルの両方を跨る場合、ピボットモデルはラベル書式とデータ書式を独立して扱うため、別々のラベル規則とデータ規則に分解されます。CellArea インスタンスへと解決することがあります。総計行や項目が連続しないフィールドなどの意味的領域は、複数の矩形にまたがることがあります。そのため、PivotArea.getCellAreas() は単一の矩形ではなくコレクションを返します。PivotTable.format で実行されたすべての書式操作は PivotTable.getPivotFormats() に記録されます。各 PivotTableFormat エントリは関連付けられた PivotArea と適用された Style を示します。PivotArea のオーバーロードは呼び出しごとに正確に 1 件のエントリを追加しますが、異なる意味的領域を含む CellArea は複数のエントリを追加することがあります。PivotArea は getOnlyLabel() と getOnlyData() フラグを公開しています。以下の例はラベルと値の両方をカバーする単一の矩形をフォーマットし、PivotTable.getPivotFormats() を調査し、各保存されたピボット領域が解決する CellArea の座標を出力します。import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat
from asposecells.api import Color, CellArea, Style, BackgroundType
from asposecells.api import PivotTable, PivotArea, PivotFieldType
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
fruits = ["Apple", "Banana", "Apple", "Banana", "Cherry", "Cherry"]
years = [2024, 2024, 2025, 2025, 2024, 2025]
amounts = [100, 150, 120, 180, 90, 110]
cells.get("A1").putValue("Fruit")
cells.get("B1").putValue("Year")
cells.get("C1").putValue("Amount")
for i in range(len(fruits)):
cells.get(i + 1, 0).putValue(fruits[i])
cells.get(i + 1, 1).putValue(years[i])
cells.get(i + 1, 2).putValue(amounts[i])
pivot_table = sheet.getPivotTables().add("=A1:C7", 2, 4)
pivot_table.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivot_table.addFieldToArea(PivotFieldType.DATA, "Amount")
pivot_table.calculateData()
highlight_style = workbook.createStyle()
highlight_style.getFont().setItalic(True)
highlight_style.setForegroundColor(Color.fromArgb(0xFF, 0x99, 0xCC, 0xFF))
highlight_style.setPattern(BackgroundType.SOLID)
# ONE rectangle in...
rectangle = CellArea()
rectangle.StartRow = 3
rectangle.StartColumn = 4
rectangle.EndRow = 4
rectangle.EndColumn = 5
pivot_table.format(rectangle, highlight_style)
# ...TWO semantic pivot areas out: the label part and the data part are stored separately
print("Stored formats: " + str(pivot_table.getPivotFormats().getCount()))
for i in range(pivot_table.getPivotFormats().getCount()):
stored_area = pivot_table.getPivotFormats().get(i).getPivotArea()
print(
f"Format {i}: OnlyLabel={stored_area.getOnlyLabel()}, "
f"OnlyData={stored_area.getOnlyData()}"
)
for resolved in stored_area.getCellAreas():
print(
f" rows {resolved.StartRow + 1}-{resolved.EndRow + 1}, "
f"columns {resolved.StartColumn + 1}-{resolved.EndColumn + 1}"
)
# This prints:
# Stored formats: 2
# Format 0: OnlyLabel=True, OnlyData=False
# rows 4-5, columns 5-5 (E4:E5, the label part)
# Format 1: OnlyLabel=False, OnlyData=True
# rows 4-5, columns 6-6 (F4:F5, the data part)
workbook.save("FormatPivotAreasMap.xlsx")
jpype.shutdownJVM()
PivotTable.refreshData() でピボットテーブルを更新したり、PivotTable.calculateData() で再計算したり、保存して再ロードしたりすると、保存されたすべてのピボット領域が現在の領域位置に再解決され、スタイルが再適用されます。
ハイライトをリフレッシュ後もフィールドや意味的領域に付随させる必要がある場合は、select または selectField で構築した PivotArea を使用し、現在のピボットテーブルレイアウト内の固定矩形をフォーマットするだけでよい場合は CellArea を使用します。単一セルの format(int row, int column, Style) オーバーロードは個別のセルを対象とします。ピボットテーブル全体を一度に再スタイル設定したい場合は、親ページで説明されている formatAll を使用してください。
Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.