Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
PivotTable.formatAll tillämpar en enda stil på hela pivottabellen och behandlas på den överordnade sidan. Den skiljer inte mellan etiketter, värden, totaler eller specifika områden i rapporten.
I praktiken behöver vanligtvis bara en del av en pivottabell framhävas. Vanliga mål inkluderar etiketter som tillhör ett radfält, värdecellerna som produceras av ett fält, totalraden eller en godtycklig rektangel såsom de två första objektraderna.
Att tillämpa en stil direkt på kalkylbladcellerna i en pivottabell är inte detsamma. Excel lagrar pivottabellens formatering som semantiska PivotArea‑regioner istället för vanliga cell‑stilsregister. En pivot‑area‑format förblir fäst vid en region, till exempel ett fälts etiketter eller datavärden, och den omvärderas när pivottabellen beräknas om, uppdateras eller expanderas. En stil som skrivs direkt till en cell tillhör däremot den cellens position och spåras inte av pivottabellmodellen.
Aspose.Cells exponerar hela PivotTable.format‑överladdningsfamiljen så att båda typerna av formatering är tillgängliga:
format(PivotArea, Style) fäster en stil vid en semantisk region som byggs med PivotArea.select eller PivotArea.selectField.format(CellArea, Style) fäster en stil vid en kalkylbladrektangel inom pivottabellen.format(number row, number column, Style) riktar sig mot en enskild cell.formatAll(Style) formaterar hela pivottabellen.Arbetssättet för semantiska områden är den rekommenderade metoden när en markering måste följa ett fält eller en region i rapporten.
PivotArea med new PivotArea(pivotTable). Objektet beskriver en semantisk region som tillhör den specifika pivottabellen.PivotArea.select(PivotFieldType axisType, number fieldPosition, PivotTableSelectionType selectionType).
PivotTableSelectionType.DataAndLabel väljer både fältets etiketter och data.PivotTableSelectionType.LabelOnly väljer endast fältets etiketter.PivotTableSelectionType.DataOnly väljer endast fältets dataceller.PivotArea.selectField(PivotFieldType axisType, string fieldName). När ett radfält väljs efter namn löser regionen upp till de värdeceller som produceras av fältets objekt.Style med workbook.createStyle(), konfigurera dess teckensnitt, förgrundsfärg och solitt bakgrundsmönster, och skicka stilen till pivotTable.format(area, style).PivotArea‑överlagringen lägger till ett PivotTableFormat‑objekt i pivotTable.getPivotFormats().pivotTable.calculateData() efter att formateringen har tillämpats så att stilarna blir synliga.Fruit‑radetiketterna med PivotArea.select och PivotTableSelectionType.LabelOnly, formaterar värdecellerna som produceras av samma radfält med PivotArea.selectField, och beräknar sedan om pivottabellen så att båda stilarna målas.const AsposeCells = require("aspose.cells.node");
const workbook = new AsposeCells.Workbook();
const sheet = workbook.getWorksheets().get(0);
const cells = sheet.getCells();
// Fruit sales data
const fruits = ["Apple", "Banana", "Apple", "Banana", "Cherry", "Cherry"];
const years = [2024, 2024, 2025, 2025, 2024, 2025];
const amounts = [100, 150, 120, 180, 90, 110];
cells.get("A1").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");
for (let i = 0; i < fruits.length; i++) {
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
const pivotTable = sheet.getPivotTables().add("=A1:C7", 2, 4);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
// Bold yellow fill on the row field's label cells
const labelStyle = workbook.createStyle();
labelStyle.getFont().setIsBold(true);
labelStyle.setForegroundColor(AsposeCells.Color.Yellow);
labelStyle.setPattern(AsposeCells.BackgroundType.Solid);
const labelArea = new AsposeCells.PivotArea(pivotTable);
labelArea.select(
AsposeCells.PivotFieldType.Row,
0,
AsposeCells.PivotTableSelectionType.LabelOnly
);
pivotTable.format(labelArea, labelStyle);
// Light green fill on the value cells the row field produces
const valueStyle = workbook.createStyle();
valueStyle.setForegroundColor(AsposeCells.Color.LightGreen);
valueStyle.setPattern(AsposeCells.BackgroundType.Solid);
const valueArea = new AsposeCells.PivotArea(pivotTable);
valueArea.selectField(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.format(valueArea, valueStyle);
// Field-anchored formats are painted when the data is calculated
pivotTable.calculateData();
// Label cells E4:E6 are now bold on yellow, value cells F4:F6 are light green
workbook.save("FormatPivotArea.xlsx");
Använd PivotTable.format(CellArea, Style) när det intressanta området är en vanlig kalkylbladrektangel snarare än ett semantiskt pivot‑område.
CellArea beskrivs av egenskaperna startRow, startColumn, endRow och endColumn. Värdena är nollbaserade kalkylbladskoordinater, och slutkoordinaterna identifierar den sista raden och kolumnen som inkluderas i rektangeln, så området omfattar cellerna från startpositionen till slutpositionen inklusive.
Till skillnad från ett fältanknutet format appliceras ett CellArea‑format på cellerna omedelbart. Ett ytterligare anrop av pivotTable.calculateData() behövs inte för att stilen ska visas.
En CellArea‑rektangel kan innehålla både etikettceller och värdeceller samtidigt. Nästa avsnitt beskriver hur Aspose.Cells och Excel representerar den rektangeln internt.
Följande exempel formaterar rektangeln E4:F5 i pivottabellen med en kursiv, ljusblå stil och sparar arbetsboken utan ytterligare beräkning.
const AsposeCells = require("aspose.cells.node");
const workbook = new AsposeCells.Workbook();
const sheet = workbook.getWorksheets().get(0);
const cells = sheet.getCells();
const fruits = ["Apple", "Banana", "Apple", "Banana", "Cherry", "Cherry"];
const years = [2024, 2024, 2025, 2025, 2024, 2025];
const amounts = [100, 150, 120, 180, 90, 110];
cells.get("A1").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");
for (let i = 0; i < fruits.length; i++) {
cells.get(i + 1, 0).putValue(fruits[i]);
cells.get(i + 1, 1).putValue(years[i]);
cells.get(i + 1, 2).putValue(amounts[i]);
}
const pivotTable = sheet.getPivotTables().add("=A1:C7", 2, 4);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
// Highlight the first two fruit rows (the rectangle E4:F5)
const highlightStyle = workbook.createStyle();
highlightStyle.getFont().setIsItalic(true);
highlightStyle.setForegroundColor(AsposeCells.Color.LightBlue);
highlightStyle.setPattern(AsposeCells.BackgroundType.Solid);
const rectangle = new AsposeCells.CellArea();
rectangle.startRow = 3;
rectangle.startColumn = 4;
rectangle.endRow = 4;
rectangle.endColumn = 5;
pivotTable.format(rectangle, highlightStyle);
// E4:F5 is italic on light blue immediately, no recalculation needed
workbook.save("FormatPivotCellArea.xlsx");
Excel lagrar pivottabellens formatering som pivotArea‑poster snarare än som vanliga kalkylblad‑cell‑stilsregister. Samma modell används av Aspose.Cells, så en formateringsbegäran översätts till pivot‑områden när den registreras.
Relationen mellan den CellArea som användaren tillhandahåller och de pivot‑områden som lagras internt är många‑till‑många i båda riktningarna.
CellArea kan producera flera pivot‑områden. Om rektangeln sträcker sig över både etikettceller och värdeceller delas den upp i separata etikett‑ och dataregler, eftersom pivot‑modellen behandlar etikettformatering och dataformatering oberoende.CellArea‑instanser. En semantisk region såsom en rad med totalsumma, eller ett fält vars objekt inte är sammanhängande, kan omfatta flera rektanglar. Detta är orsaken till att PivotArea.getCellAreas() returnerar en samling istället för en enda rektangel.pivotTable.format() registreras i pivotTable.getPivotFormats(). Varje PivotTableFormat‑post visar den associerade PivotArea samt den Style som tillämpas på den. PivotArea‑överlagringen lägger till exakt en post per anrop, medan ett CellArea‑format som innehåller olika semantiska regioner kan lägga till flera poster.PivotArea flaggorna getOnlyLabel() och getOnlyData(). Exemplet nedan formaterar en enda rektangel som omfattar både etiketter och värden, inspekterar pivotTable.getPivotFormats() och skriver ut de CellArea‑koordinater som varje lagrat pivot‑område löses upp till.const AsposeCells = require("aspose.cells.node");
const workbook = new AsposeCells.Workbook();
const sheet = workbook.getWorksheets().get(0);
const cells = sheet.getCells();
const fruits = ["Apple", "Banana", "Apple", "Banana", "Cherry", "Cherry"];
const years = [2024, 2024, 2025, 2025, 2024, 2025];
const amounts = [100, 150, 120, 180, 90, 110];
cells.get("A1").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");
for (let i = 0; i < fruits.length; i++) {
cells.get(i + 1, 0).putValue(fruits[i]);
cells.get(i + 1, 1).putValue(years[i]);
cells.get(i + 1, 2).putValue(amounts[i]);
}
const pivotTable = sheet.getPivotTables().add("=A1:C7", 2, 4);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
const highlightStyle = workbook.createStyle();
highlightStyle.getFont().setIsItalic(true);
highlightStyle.setForegroundColor(AsposeCells.Color.LightBlue);
highlightStyle.setPattern(AsposeCells.BackgroundType.Solid);
// ONE rectangle in...
const rectangle = new AsposeCells.CellArea();
rectangle.startRow = 3;
rectangle.startColumn = 4;
rectangle.endRow = 4;
rectangle.endColumn = 5;
pivotTable.format(rectangle, highlightStyle);
// ...TWO semantic pivot areas out: the label part and the data part are stored separately
console.log("Stored formats: " + pivotTable.getPivotFormats().getCount());
for (let i = 0; i < pivotTable.getPivotFormats().getCount(); i++) {
const storedArea = pivotTable.getPivotFormats().get(i).getPivotArea();
console.log(
`Format ${i}: OnlyLabel=${storedArea.getOnlyLabel()}, OnlyData=${storedArea.getOnlyData()}`
);
const resolvedAreas = storedArea.getCellAreas();
for (const resolved of resolvedAreas) {
console.log(
` rows ${resolved.startRow + 1}-${resolved.endRow + 1}, ` +
`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");
pivotTable.refreshData(), beräknas om med pivotTable.calculateData(), eller sparas och laddas om, löser varje lagrat pivot‑område sig på nytt till den aktuella positionen för sin region och dess stil återappliceras.
Använd en PivotArea byggd med select eller selectField när en markering måste förbli fäst vid ett fält eller en semantisk region över uppdateringar, och använd ett CellArea när formatering av en fast rektangel i den nuvarande pivottabellslayouten är tillräckligt. En‑cell‑överlagring format(number row, number column, Style) riktar sig mot en individuell cell. Använd formatAll, som behandlas på den överordnade sidan, när hela pivottabellen ska omformateras på en gång.
Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.