https://docs.aspose.com/cells/de/javascript-cpp/apply-style-to-pivot-table/ Recent content in Stile auf PivotTables in Aspose.Cells for JavaScript via C++ anwenden on Documentation Hugo -- gohugo.io de https://docs.aspose.com/cells/de/javascript-cpp/format-part-of-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/de/javascript-cpp/format-part-of-pivot-table/ <h2 id="mögliche-anwendungsfälle"><strong>Mögliche Anwendungsfälle</strong></h2> <p><code>PivotTable.FormatAll</code> wendet einen einzigen Stil auf die gesamte PivotTable an und wird auf der übergeordneten Seite behandelt. Es unterscheidet nicht zwischen Beschriftungen, Werten, Summen oder bestimmten Bereichen des Berichts.<br> In der Praxis muss in der Regel nur ein Teil einer PivotTable hervorgehoben werden. Häufige Ziele sind die Beschriftungen, die zu einem Zeilenfeld gehören, die Wertzellen, die von einem Feld erzeugt werden, die Gesamtsummenzeile oder ein beliebiges Rechteck wie die ersten beiden Elementzeilen.<br> Das direkte Anwenden eines Stils auf die Arbeitsblattzellen einer PivotTable ist nicht gleichwertig. Excel speichert die Formatierung von PivotTables als semantische <code>PivotArea</code>‑Bereiche statt als gewöhnliche Zellformat‑Einträge. Ein <code>PivotArea</code>‑Format bleibt an einem Bereich wie den Beschriftungen eines Feldes oder Datenwerten befestigt und wird neu aufgelöst, wenn die PivotTable neu berechnet, aktualisiert oder erweitert wird. Ein direkt in eine Zelle geschriebener Stil hingegen gehört zu dieser Zellenposition und wird vom Pivot‑Modell nicht verfolgt.<br> Aspose.Cells stellt die vollständige Überladungsfamilie von <code>PivotTable.Format</code> zur Verfügung, sodass beide Arten der Formatierung verfügbar sind:</p> <ul> <li><code>Format(PivotArea, Style)</code> verankert einen Stil an einem semantischen Bereich, der mit <code>PivotArea.Select</code> oder <code>PivotArea.SelectField</code> erstellt wird.</li> <li><code>Format(CellArea, Style)</code> verankert einen Stil an einem Arbeitsblatt‑Rechteck innerhalb der PivotTable.</li> <li><code>Format(int row, int column, Style)</code> richtet sich an eine einzelne Zelle.</li> <li><code>FormatAll(Style)</code> formatiert die gesamte PivotTable.</li> </ul> <h2 id="pivotarea-formatieren"><strong>PivotArea formatieren</strong></h2> <p>Der semantische‑Bereich‑Workflow ist der empfohlene Ansatz, wenn eine Hervorhebung einem Feld oder einem Bereich des Berichts folgen muss.</p> <ol> <li>Erstelle ein <code>PivotArea</code> mit <code>new PivotArea(pivotTable)</code>. Das Objekt beschreibt einen semantischen Bereich, der zu dieser spezifischen PivotTable gehört.</li> <li>Wähle ein Feld anhand seiner nullbasierten Position auf einer angegebenen Achse mit <code>PivotArea.Select(PivotFieldType axisType, int fieldPosition, PivotTableSelectionType selectionType)</code> aus. <ul> <li><code>PivotTableSelectionType.DataAndLabel</code> wählt sowohl die Beschriftungen als auch die Daten des Feldes aus.</li> <li><code>PivotTableSelectionType.LabelOnly</code> wählt nur die Beschriftungen des Feldes aus.</li> <li><code>PivotTableSelectionType.DataOnly</code> wählt nur die Datenzellen des Feldes aus.</li> </ul> </li> <li>Wähle ein Feld anhand des Namens mit <code>PivotArea.SelectField(PivotFieldType axisType, string fieldName)</code> aus. Wird ein Zeilenfeld nach Name ausgewählt, löst sich der Bereich zu den von den Elementen dieses Feldes erzeugten Wertzellen auf.</li> <li>Erstelle einen <code>Style</code> mit <code>Workbook.CreateStyle()</code>, konfiguriere seine Schriftart, Vordergrundfarbe und ein einheitliches Hintergrundmuster und übergebe den Stil an <code>PivotTable.Format(area, style)</code>.</li> <li>Jeder Aufruf der <code>PivotArea</code>‑Überladung fügt einen <code>PivotTableFormat</code>‑Eintrag zu <code>PivotTable.PivotFormats</code> hinzu.</li> <li>Feldverankerte Formate werden gezeichnet, wenn die PivotTable‑Daten berechnet werden. Daher rufe <code>PivotTable.CalculateData()</code> nach dem Anwenden der Formate auf, damit die Stile sichtbar werden.<br> Das folgende Beispiel erstellt eine kleine PivotTable für Obstverkäufe, formatiert die Zeilenbeschriftungen <code>Fruit</code> mit <code>PivotArea.Select</code> und <code>PivotTableSelectionType.LabelOnly</code>, formatiert die von demselben Zeilenfeld erzeugten Wertzellen mit <code>PivotArea.SelectField</code> und berechnet anschließend die PivotTable neu, sodass beide Stile angewendet werden.</li> </ol> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html"><span class="cp">&lt;!DOCTYPE html&gt;</span> <span class="p">&lt;</span><span class="nt">html</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">title</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">button</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;runExample&#34;</span><span class="p">&gt;</span>Run Example<span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;downloadLink&#34;</span> <span class="na">style</span><span class="o">=</span><span class="s">&#34;display: none;&#34;</span><span class="p">&gt;</span>Download Result<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;result&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&#34;aspose.cells.js.min.js&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">&#34;text/javascript&#34;</span><span class="p">&gt;</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">({</span> <span class="nx">license</span><span class="o">:</span> <span class="s2">&#34;/lic/aspose.cells.enc&#34;</span><span class="p">,</span> <span class="nx">fontPath</span><span class="o">:</span> <span class="s2">&#34;/fonts/&#34;</span><span class="p">,</span> <span class="nx">fontList</span><span class="o">:</span> <span class="p">[</span><span class="s2">&#34;arial.ttf&#34;</span><span class="p">,</span> <span class="s2">&#34;NotoSansSC-Regular.ttf&#34;</span><span class="p">]</span> <span class="p">}).</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Aspose.Cells initialized&#34;</span><span class="p">);</span> <span class="p">});</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;runExample&#39;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">&#39;click&#39;</span><span class="p">,</span> <span class="kr">async</span> <span class="p">()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="c1">// Fruit sales data </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Year&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Amount&#34;</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="p">}</span> <span class="c1">// Pivot table with its top-left corner at E3 (row 2, column 4) </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Bold yellow fill on the row field&#39;s label cells </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">labelStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">labelStyle</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isBold</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">labelStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">Color</span><span class="p">.</span><span class="nx">Yellow</span><span class="p">;</span> <span class="nx">labelStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">labelArea</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotArea</span><span class="p">(</span><span class="nx">pivotTable</span><span class="p">);</span> <span class="nx">labelArea</span><span class="p">.</span><span class="nx">select</span><span class="p">(</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotTableSelectionType</span><span class="p">.</span><span class="nx">LabelOnly</span> <span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">labelArea</span><span class="p">,</span> <span class="nx">labelStyle</span><span class="p">);</span> <span class="c1">// Light green fill on the value cells the row field produces </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">valueStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">valueStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">Color</span><span class="p">.</span><span class="nx">LightGreen</span><span class="p">;</span> <span class="nx">valueStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">valueArea</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotArea</span><span class="p">(</span><span class="nx">pivotTable</span><span class="p">);</span> <span class="nx">valueArea</span><span class="p">.</span><span class="nx">selectField</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">valueArea</span><span class="p">,</span> <span class="nx">valueStyle</span><span class="p">);</span> <span class="c1">// Field-anchored formats are painted when the data is calculated </span><span class="c1"></span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Label cells E4:E6 are now bold on yellow, value cells F4:F6 are light green </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">outputData</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">blob</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Blob</span><span class="p">([</span><span class="nx">outputData</span><span class="p">]);</span> <span class="kr">const</span> <span class="nx">downloadLink</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;downloadLink&#39;</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">href</span> <span class="o">=</span> <span class="nx">URL</span><span class="p">.</span><span class="nx">createObjectURL</span><span class="p">(</span><span class="nx">blob</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">download</span> <span class="o">=</span> <span class="s2">&#34;FormatPivotArea.xlsx&#34;</span><span class="p">;</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">display</span> <span class="o">=</span> <span class="s2">&#34;block&#34;</span><span class="p">;</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;result&#39;</span><span class="p">).</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="s1">&#39;&lt;p style=&#34;color: green;&#34;&gt;Done! Click the download link to get the result file.&lt;/p&gt;&#39;</span><span class="p">;</span> <span class="p">});</span> <span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">html</span><span class="p">&gt;</span> </code></pre></div><h2 id="cellarea-der-pivottable-formatieren"><strong>CellArea der PivotTable formatieren</strong></h2> <p>Verwende <code>PivotTable.Format(CellArea, Style)</code>, wenn der interessierende Bereich ein einfaches Arbeitsblatt‑Rechteck und kein semantischer Pivot‑Bereich ist.<br> <code>CellArea</code> wird durch die Felder <code>startRow</code>, <code>startColumn</code>, <code>endRow</code> und <code>endColumn</code> beschrieben. Die Werte sind nullbasierte Arbeitsblattkoordinaten, und die Endkoordinaten geben die letzte Zeile und Spalte an, die im Rechteck enthalten sind, sodass der Bereich die Zellen von der Start‑ bis zur Endposition (inklusive) umfasst.<br> Im Gegensatz zu einem feldverankerten Format wird ein <code>CellArea</code>‑Format sofort auf die Zellen angewendet. Ein weiterer Aufruf von <code>CalculateData()</code> ist nicht erforderlich, damit der Stil erscheint.<br> Ein <code>CellArea</code>‑Rechteck kann sowohl Beschriftungszellen als auch Wertzellen enthalten. Der nächste Abschnitt beschreibt, wie Aspose.Cells und Excel dieses Rechteck intern darstellen.<br> Das folgende Beispiel formatiert das Rechteck <code>E4:F5</code> der PivotTable mit einem kursiven, hellblauen Stil und speichert die Arbeitsmappe ohne weitere Neuberechnung.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html"><span class="cp">&lt;!DOCTYPE html&gt;</span> <span class="p">&lt;</span><span class="nt">html</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">title</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">button</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;runExample&#34;</span><span class="p">&gt;</span>Run Example<span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;downloadLink&#34;</span> <span class="na">style</span><span class="o">=</span><span class="s">&#34;display: none;&#34;</span><span class="p">&gt;</span>Download Result<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;result&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&#34;aspose.cells.js.min.js&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">&#34;text/javascript&#34;</span><span class="p">&gt;</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">({</span> <span class="nx">license</span><span class="o">:</span> <span class="s2">&#34;/lic/aspose.cells.enc&#34;</span><span class="p">,</span> <span class="nx">fontPath</span><span class="o">:</span> <span class="s2">&#34;/fonts/&#34;</span><span class="p">,</span> <span class="nx">fontList</span><span class="o">:</span> <span class="p">[</span><span class="s2">&#34;arial.ttf&#34;</span><span class="p">,</span> <span class="s2">&#34;NotoSansSC-Regular.ttf&#34;</span><span class="p">]</span> <span class="p">}).</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Aspose.Cells initialized&#34;</span><span class="p">);</span> <span class="p">});</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;runExample&#39;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">&#39;click&#39;</span><span class="p">,</span> <span class="kr">async</span> <span class="p">()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Year&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Amount&#34;</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Highlight the first two fruit rows (the rectangle E4:F5) </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">highlightStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isItalic</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">Color</span><span class="p">.</span><span class="nx">LightBlue</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">rectangle</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">CellArea</span><span class="p">();</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">=</span> <span class="mi">3</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">rectangle</span><span class="p">,</span> <span class="nx">highlightStyle</span><span class="p">);</span> <span class="c1">// E4:F5 is italic on light blue immediately, no recalculation needed </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">outputData</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">blob</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Blob</span><span class="p">([</span><span class="nx">outputData</span><span class="p">]);</span> <span class="kr">const</span> <span class="nx">downloadLink</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;downloadLink&#39;</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">href</span> <span class="o">=</span> <span class="nx">URL</span><span class="p">.</span><span class="nx">createObjectURL</span><span class="p">(</span><span class="nx">blob</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">download</span> <span class="o">=</span> <span class="s2">&#34;FormatPivotCellArea.xlsx&#34;</span><span class="p">;</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">display</span> <span class="o">=</span> <span class="s2">&#34;block&#34;</span><span class="p">;</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;result&#39;</span><span class="p">).</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="s1">&#39;&lt;p style=&#34;color: green;&#34;&gt;Done! Click the download link to get the result file.&lt;/p&gt;&#39;</span><span class="p">;</span> <span class="p">});</span> <span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">html</span><span class="p">&gt;</span> </code></pre></div><h2 id="wie-pivotarea-und-cellarea-abgebildet-werden"><strong>Wie PivotArea und CellArea abgebildet werden</strong></h2> <p>Excel speichert die Formatierung von PivotTables als <code>pivotArea</code>‑Einträge statt als gewöhnliche Arbeitsblatt‑Zellstil‑Einträge. Dasselbe Modell wird von Aspose.Cells verwendet, sodass eine Formatierungsanforderung beim Aufzeichnen in PivotArea‑Bereiche übersetzt wird.<br> Die Beziehung zwischen dem vom Benutzer bereitgestellten <code>CellArea</code> und den intern gespeicherten PivotArea‑Einträgen ist in beide Richtungen viele‑zu‑viele.</p> <ul> <li>Ein <code>CellArea</code> kann mehrere PivotArea erzeugen. Wenn das Rechteck sowohl Beschriftungs‑ als auch Wertzellen umfasst, wird es in separate Beschriftungs‑ und Datenregeln aufgeteilt, da das Pivot‑Modell Beschriftungs‑ und Datenformatierung unabhängig behandelt.</li> <li>Eine PivotArea kann sich in mehrere disjunkte <code>CellArea</code>‑Instanzen auflösen. Ein semantischer Bereich wie eine Gesamtsummenzeile oder ein Feld, dessen Elemente nicht zusammenhängend sind, kann mehrere Rechtecke abdecken. Deshalb gibt <code>PivotArea.GetCellAreas()</code> eine Sammlung zurück statt eines einzelnen Rechtecks. Jeder über <code>PivotTable.Format</code> ausgeführte Formatierungsvorgang wird in <code>PivotTable.PivotFormats</code> aufgezeichnet. Jeder <code>PivotTableFormat</code>‑Eintrag stellt das zugehörige <code>PivotArea</code> und den darauf angewendeten <code>Style</code> bereit. Die <code>PivotArea</code>‑Überladung fügt genau einen Eintrag pro Aufruf hinzu, während ein <code>CellArea</code>, das verschiedene semantische Regionen enthält, mehrere Einträge hinzufügen kann.<br> Um die gespeicherten Regionen zu unterscheiden, stellt jedes <code>PivotArea</code> die Flags <code>OnlyLabel</code> und <code>OnlyData</code> bereit. Das untenstehende Beispiel formatiert ein einzelnes Rechteck, das sowohl Beschriftungen als auch Werte abdeckt, untersucht <code>PivotTable.PivotFormats</code> und gibt die <code>CellArea</code>‑Koordinaten aus, zu denen jede gespeicherte PivotArea aufgelöst wird.</li> </ul> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html"><span class="cp">&lt;!DOCTYPE html&gt;</span> <span class="p">&lt;</span><span class="nt">html</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">title</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">button</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;runExample&#34;</span><span class="p">&gt;</span>Run Example<span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;downloadLink&#34;</span> <span class="na">style</span><span class="o">=</span><span class="s">&#34;display: none;&#34;</span><span class="p">&gt;</span>Download Result<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;result&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&#34;aspose.cells.js.min.js&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">&#34;text/javascript&#34;</span><span class="p">&gt;</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">CellArea</span><span class="p">,</span> <span class="nx">Color</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">({</span> <span class="nx">license</span><span class="o">:</span> <span class="s2">&#34;/lic/aspose.cells.enc&#34;</span><span class="p">,</span> <span class="nx">fontPath</span><span class="o">:</span> <span class="s2">&#34;/fonts/&#34;</span><span class="p">,</span> <span class="nx">fontList</span><span class="o">:</span> <span class="p">[</span><span class="s2">&#34;arial.ttf&#34;</span><span class="p">,</span> <span class="s2">&#34;NotoSansSC-Regular.ttf&#34;</span><span class="p">]</span> <span class="p">}).</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Aspose.Cells initialized&#34;</span><span class="p">);</span> <span class="p">});</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s2">&#34;runExample&#34;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s2">&#34;click&#34;</span><span class="p">,</span> <span class="kr">async</span> <span class="p">()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">result</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s2">&#34;result&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">downloadLink</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s2">&#34;downloadLink&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Year&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Amount&#34;</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">highlightStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isItalic</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">LightBlue</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="c1">// ONE rectangle in... </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">rectangle</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">CellArea</span><span class="p">();</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">=</span> <span class="mi">3</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="c1">// ...TWO semantic pivot areas out: the label part and the data part are stored separately </span><span class="c1"></span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">rectangle</span><span class="p">,</span> <span class="nx">highlightStyle</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">pivotFormats</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">pivotFormats</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">outputLines</span> <span class="o">=</span> <span class="p">[</span><span class="sb">`Stored formats: </span><span class="si">${</span><span class="nx">pivotFormats</span><span class="p">.</span><span class="nx">count</span><span class="si">}</span><span class="sb">`</span><span class="p">];</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">pivotFormats</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">pivotFormat</span> <span class="o">=</span> <span class="nx">pivotFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">storedArea</span> <span class="o">=</span> <span class="nx">pivotFormat</span><span class="p">.</span><span class="nx">pivotArea</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">onlyLabel</span> <span class="o">=</span> <span class="nx">storedArea</span><span class="p">.</span><span class="nx">onlyLabel</span> <span class="o">?</span> <span class="s2">&#34;True&#34;</span> <span class="o">:</span> <span class="s2">&#34;False&#34;</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">onlyData</span> <span class="o">=</span> <span class="nx">storedArea</span><span class="p">.</span><span class="nx">onlyData</span> <span class="o">?</span> <span class="s2">&#34;True&#34;</span> <span class="o">:</span> <span class="s2">&#34;False&#34;</span><span class="p">;</span> <span class="nx">outputLines</span><span class="p">.</span><span class="nx">push</span><span class="p">(</span><span class="sb">`Format </span><span class="si">${</span><span class="nx">i</span><span class="si">}</span><span class="sb">: OnlyLabel=</span><span class="si">${</span><span class="nx">onlyLabel</span><span class="si">}</span><span class="sb">, OnlyData=</span><span class="si">${</span><span class="nx">onlyData</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">resolvedAreas</span> <span class="o">=</span> <span class="nx">storedArea</span><span class="p">.</span><span class="nx">cellAreas</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">j</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">j</span> <span class="o">&lt;</span> <span class="nx">resolvedAreas</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">j</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">resolved</span> <span class="o">=</span> <span class="nx">resolvedAreas</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">j</span><span class="p">);</span> <span class="nx">outputLines</span><span class="p">.</span><span class="nx">push</span><span class="p">(</span> <span class="sb">` rows </span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">-</span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">, columns </span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">-</span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">`</span> <span class="p">);</span> <span class="p">}</span> <span class="p">}</span> <span class="c1">// This prints: </span><span class="c1"></span> <span class="c1">// Stored formats: 2 </span><span class="c1"></span> <span class="c1">// Format 0: OnlyLabel=True, OnlyData=False </span><span class="c1"></span> <span class="c1">// rows 4-5, columns 5-5 (E4:E5, the label part) </span><span class="c1"></span> <span class="c1">// Format 1: OnlyLabel=False, OnlyData=True </span><span class="c1"></span> <span class="c1">// rows 4-5, columns 6-6 (F4:F5, the data part) </span><span class="c1"></span> <span class="nx">result</span><span class="p">.</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="sb">`&lt;pre&gt;</span><span class="si">${</span><span class="nx">outputLines</span><span class="p">.</span><span class="nx">join</span><span class="p">(</span><span class="s2">&#34;\n&#34;</span><span class="p">)</span><span class="si">}</span><span class="sb">&lt;/pre&gt;`</span> <span class="o">+</span> <span class="sb">`&lt;p style=&#34;color: green;&#34;&gt;Done! Click the download link to get the result file.&lt;/p&gt;`</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">outputData</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">blob</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Blob</span><span class="p">([</span><span class="nx">outputData</span><span class="p">]);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">href</span> <span class="o">=</span> <span class="nx">URL</span><span class="p">.</span><span class="nx">createObjectURL</span><span class="p">(</span><span class="nx">blob</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">download</span> <span class="o">=</span> <span class="s2">&#34;FormatPivotAreasMap.xlsx&#34;</span><span class="p">;</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">display</span> <span class="o">=</span> <span class="s2">&#34;block&#34;</span><span class="p">;</span> <span class="p">});</span> <span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">html</span><span class="p">&gt;</span> </code></pre></div> <div class="alert alert-primary" role="alert"> Da die Formate als PivotAreas und nicht als gewöhnliche Zellstile gespeichert werden, überleben sie Neu‑Berechnungen und Aktualisierungen. Wenn die PivotTable mit <code>PivotTable.RefreshData</code> aktualisiert, mit <code>CalculateData</code> neu berechnet oder gespeichert und erneut geladen wird, löst sich jede gespeicherte PivotArea erneut an die aktuelle Position ihres Bereichs auf und ihr Stil wird wieder angewendet. </div> <p>Verwende ein <code>PivotArea</code>, das mit <code>Select</code> oder <code>SelectField</code> erstellt wurde, wenn eine Hervorhebung über Aktualisierungen hinweg an einem Feld oder einem semantischen Bereich befestigt bleiben muss, und verwende ein <code>CellArea</code>, wenn das Formatieren eines festen Rechtecks im aktuellen Pivot‑Tabellen‑Layout ausreicht. Die Einzelzellen‑Überladung <code>Format(int row, int column, Style)</code> richtet sich an eine einzelne Zelle. Verwende <code>FormatAll</code>, das auf der übergeordneten Seite behandelt wird, wenn die gesamte PivotTable auf einmal neu gestaltet werden soll.</p> <h2 id="verwandte-artikel"><strong>Verwandte Artikel</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/apply-style-to-pivot-table/">Stil auf PivotTable anwenden</a></li> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/pivot-table-add-row-and-column-fields/">PivotTable‑Zeilen‑ und Spaltenfelder hinzufügen</a></li> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/manage-value-fields/">Wertfelder in PivotTable verwalten</a></li> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/refresh-pivot-table/">PivotTable aktualisieren</a></li> </ul> <button class="floating-button" id="openModalBtn">AI Document Assistant</button> <div class="modal" id="modal"> <button class="close-btn" id="closeModalBtn">Close</button> <iframe src="https://products.aspose.ai/cells/chat/document/javascript-cpp?source=docs" frameborder="0" width="100%" height="100%"></iframe> </div> <style> .floating-button { position: fixed; bottom: 20px; right: 20px; background-color: #007bff; color: white; border: none; padding: 15px 20px; border-radius: 50px; cursor: pointer; font-size: 16px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2); z-index: 999; } .modal { display: none; position: fixed; top: 10%; left: 10%; width: 80%; height: 80%; background-color: white; border: none; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3); z-index: 1000; padding: 20px; box-sizing: border-box; } .close-btn { position: absolute; top: 10px; right: 10px; background-color: #f44336; color: white; border: none; padding: 5px 10px; cursor: pointer; font-size: 16px; border-radius: 3px; } </style> <script> const openModalBtn = document.getElementById('openModalBtn'); const closeModalBtn = document.getElementById('closeModalBtn'); const modal = document.getElementById('modal'); openModalBtn.addEventListener('click', function() { modal.style.display = 'block'; }); closeModalBtn.addEventListener('click', function() { modal.style.display = 'none'; }); window.addEventListener('click', function(event) { if (event.target === modal) { modal.style.display = 'none'; } }); </script> https://docs.aspose.com/cells/de/javascript-cpp/add-conditional-formatting-to-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/de/javascript-cpp/add-conditional-formatting-to-pivot-table/ <h2 id="mögliche-anwendungsszenarien"><strong>Mögliche Anwendungsszenarien</strong></h2> <p>Die auf der übergeordneten Seite und der verwandten Seite beschriebenen Stile sind statisch – ein <code>PivotArea</code>‑ oder <code>CellArea</code>‑Bereich wird einmal gemalt und behält sein Format, unabhängig von den Werten. Bedingte Formatierung ist das regelbasierte Gegenstück – jede Summe über 200 hervorheben, die mittleren fünfzig Prozent schattieren oder die am schlechtesten platzierten Elemente markieren – und die Hervorhebung folgt den Werten, wann immer die PivotTable neu berechnet oder aktualisiert wird. In Aspose.Cells befindet sich die bedingte Formatierung von PivotTable in der Sammlung <code>pivotTable.conditionalFormats</code>. Jeder Eintrag ist ein <code>PivotConditionalFormat</code>, der zwei Fragen unabhängig beantwortet:</p> <ul> <li><strong>Wo wird die Regel angewendet?</strong> Der Zielbereich wird entweder über <code>applyTo(row, column, scope)</code> definiert, was dem Bereichsauswahl‑Tool der Excel‑Benutzeroberfläche entspricht, oder über <code>addCellArea(cellArea)</code> und die Sammlung <code>pivotAreas</code>, die den Bereich explizit benennen.</li> <li><strong>Was prüft die Regel?</strong> Eine oder mehrere Bedingungen werden zu <code>formatConditions</code> mit <code>addCondition(type, operatorType, formula1, formula2)</code> hinzugefügt, und jede Bedingung trägt ihr eigenes <code>style</code>.</li> </ul> <div class="alert alert-primary" role="alert"> Rufen Sie nicht <code>formatConditions.add(cellArea, type, operatorType, formula1, formula2)</code> oder <code>formatConditions.addArea(cellArea)</code> auf dem <code>formatConditions</code>‑Objekt eines Pivot‑bedingten Formats auf. Diese beiden Überladungen stammen aus der regulären Worksheet‑Bedingten‑Formatierungs‑API und funktionieren nicht für Pivot‑Tabellen – der Zellbereich wird nie in einen Pivot‑Bereich konvertiert, sodass die Anforderung stillschweigend ignoriert wird. Definieren Sie den Bereich immer direkt auf dem <code>PivotConditionalFormat</code> selbst (<code>applyTo</code>, <code>addCellArea</code> oder <code>pivotAreas</code>) und fügen Sie die Regel mit einer der <code>addCondition</code>‑Überladungen hinzu. </div> <h2 id="eine-regel-mit-einem-bereich-anwenden-wie-in-der-excelbenutzeroberfläche"><strong>Eine Regel mit einem Bereich anwenden (wie in der Excel‑Benutzeroberfläche)</strong></h2> <p>Die erste Methode positioniert die Regel so, wie es die Excel‑Benutzeroberfläche tut. Eine Zelle der PivotTable wird durch ihre nullbasierten Arbeitsblattkoordinaten benannt, und ein <code>PivotConditionFormatScopeType</code>‑Bereich teilt Aspose.Cells mit, wie weit die Regel von dieser Zelle aus reichen soll:</p> <ul> <li><code>PivotConditionFormatScopeType.Data</code> – alle Wertzellen, die die PivotTable erzeugt, einschließlich Gesamtsummen.</li> <li><code>PivotConditionFormatScopeType.Field</code> – die Wertzellen, die zu dem Feld gehören, das die Zelle identifiziert, ohne Gesamtsummen. Die Zelle muss eine Feldzelle sein, z. B. ein Zeilenfeld‑Label; das Übergeben einer Wertzelle löst eine Ausnahme aus.</li> <li><code>PivotConditionFormatScopeType.Selection</code> – nur die Wertzellen an der Schnittstelle, die die Zelle auswählt, typischerweise eine einzelne Wertzelle. Das nachstehende Beispiel erstellt eine PivotTable für Obstverkäufe, deren obere linke Ecke bei E3 liegt, verankert ein bedingtes Format in Zelle F4 (Zeile 3, Spalte 5) mit dem <code>Data</code>‑Bereich und hebt jede Summe über 200 fett weiß auf rot hervor. Mit den Werten Apple 220, Banana 330, Cherry 200 und der Gesamtsumme 750 färbt die Regel F4, F5 und F7 – der aufgelöste Bereich ist die gesamte Datenspalte F4:F7, und nur die Zellen, deren Wert die Regel erfüllt, leuchten auf.</li> </ul> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); const { Workbook, SaveFormat, PivotFieldType, PivotConditionFormatScopeType, FormatConditionType, OperatorType, Color, BackgroundType } = AsposeCells; AsposeCells.onReady().then(() =&gt; { const workbook = new Workbook(); const sheet = workbook.worksheets.get(0); const cells = sheet.cells; const fruits = [&#34;Apple&#34;, &#34;Banana&#34;, &#34;Apple&#34;, &#34;Banana&#34;, &#34;Cherry&#34;, &#34;Cherry&#34;]; const years = [2024, 2024, 2025, 2025, 2024, 2025]; const amounts = [100, 150, 120, 180, 90, 110]; cells.get(&#34;A1&#34;).putValue(&#34;Fruit&#34;); cells.get(&#34;B1&#34;).putValue(&#34;Year&#34;); cells.get(&#34;C1&#34;).putValue(&#34;Amount&#34;); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">fruits.length</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">0</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">fruits</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">1</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">years</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">2</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">amounts</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="err">}</span> <span class="err">//</span> <span class="na">Pivot-Tabelle</span> <span class="na">mit</span> <span class="na">ihrer</span> <span class="na">oberen</span> <span class="na">linken</span> <span class="na">Ecke</span> <span class="na">bei</span> <span class="na">E3</span> <span class="na">const</span> <span class="na">pivotTable </span><span class="o">=</span> <span class="s">sheet.pivotTables.add(&#34;=A1:C7&#34;,</span> <span class="na">2</span><span class="err">,</span> <span class="na">4</span><span class="err">);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Row</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Fruit</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">calculateData</span><span class="err">();</span> <span class="err">//</span> <span class="na">Verankere</span> <span class="na">das</span> <span class="na">bedingte</span> <span class="na">Format</span> <span class="na">bei</span> <span class="na">F4</span> <span class="err">(</span><span class="na">Zeile</span> <span class="na">3</span><span class="err">,</span> <span class="na">Spalte</span> <span class="na">5</span><span class="err">)</span> <span class="na">mit</span> <span class="na">dem</span> <span class="na">Datenbereich</span> <span class="na">const</span> <span class="na">index </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.add();</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(index);</span> <span class="na">format</span><span class="err">.</span><span class="na">applyTo</span><span class="err">(</span><span class="na">3</span><span class="err">,</span> <span class="na">5</span><span class="err">,</span> <span class="na">PivotConditionFormatScopeType</span><span class="err">.</span><span class="na">Data</span><span class="err">);</span> <span class="err">//</span> <span class="na">Regel</span> <span class="err">–</span> <span class="na">hebe</span> <span class="na">Beträge</span> <span class="na">hervor</span><span class="err">,</span> <span class="na">die</span> <span class="na">größer</span> <span class="na">als</span> <span class="na">200</span> <span class="na">sind</span> <span class="na">const</span> <span class="na">conditionIndex </span><span class="o">=</span> <span class="s">format.formatConditions.addCondition(</span> <span class="na">FormatConditionType</span><span class="err">.</span><span class="na">CellValue</span><span class="err">,</span> <span class="na">OperatorType</span><span class="err">.</span><span class="na">GreaterThan</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">200</span><span class="err">&#34;,</span> <span class="na">null</span><span class="err">);</span> <span class="na">const</span> <span class="na">style </span><span class="o">=</span> <span class="s">workbook.createStyle();</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">isBold </span><span class="o">=</span> <span class="s">true;</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">color </span><span class="o">=</span> <span class="s">Color.White;</span> <span class="na">style</span><span class="err">.</span><span class="na">foregroundColor </span><span class="o">=</span> <span class="s">Color.Red;</span> <span class="na">style</span><span class="err">.</span><span class="na">pattern </span><span class="o">=</span> <span class="s">BackgroundType.Solid;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">conditionIndex</span><span class="err">).</span><span class="na">style </span><span class="o">=</span> <span class="s">style;</span> <span class="err">//</span> <span class="na">wb</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">)</span> <span class="na">gibt</span> <span class="na">die</span> <span class="na">Datei</span> <span class="na">als</span> <span class="na">Bytes</span> <span class="na">zurück</span> <span class="na">fs</span><span class="err">.</span><span class="na">writeFileSync</span><span class="err">(&#34;</span><span class="na">PivotConditionalFormatData</span><span class="err">.</span><span class="na">xlsx</span><span class="err">&#34;,</span> <span class="na">workbook</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">));</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Done</span><span class="err">;</span> <span class="na">the</span> <span class="na">rule</span> <span class="na">paints</span> <span class="na">F4</span><span class="err">,</span> <span class="na">F5</span><span class="err">,</span> <span class="na">and</span> <span class="na">F7</span><span class="err">&#34;);</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><p>Das Anbringen derselben Regel am Zeilenfeld‑Label E4 (Zeile 3, Spalte 4) mit dem <code>Field</code>‑Bereich löst stattdessen F4:F6 – dieselbe Datenspalte ohne die Gesamtsummenzeile – da der Bereich nun das <code>Fruit</code>‑Feld und nicht das gesamte Werte‑Gebiet beschreibt. Der <code>Selection</code>‑Bereich, verankert bei F4, löst nur F4 aus.</p> <h2 id="den-bereich-manuell-definieren"><strong>Den Bereich manuell definieren</strong></h2> <p>Die zweite Methode überspringt die Bereichsauswahl und benennt den Bereich explizit auf dem <code>PivotConditionalFormat</code>.</p> <h3 id="ein-arbeitsblattrechteck-mit-addcellarea"><strong>Ein Arbeitsblatt‑Rechteck mit addCellArea</strong></h3> <p><code>addCellArea(cellArea)</code> speichert das angegebene Rechteck als Ziel der Regel. Die Koordinaten sind nullbasierte Arbeitsblattkoordinaten, und der Bereich entspricht exakt dem übergebenen Rechteck – keine Erweiterung zur Datenspalte und keine Gesamtsummen‑Logik. Verwenden Sie es, wenn die interessierenden Zellen ein bekanntes festes Rechteck des aktuellen Pivot‑Layouts bilden.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); const { Workbook, SaveFormat, PivotFieldType, FormatConditionType, OperatorType, Color, BackgroundType, CellArea } = AsposeCells; AsposeCells.onReady().then(() =&gt; { const workbook = new Workbook(); const sheet = workbook.worksheets.get(0); const cells = sheet.cells; const fruits = [&#34;Apple&#34;, &#34;Banana&#34;, &#34;Apple&#34;, &#34;Banana&#34;, &#34;Cherry&#34;, &#34;Cherry&#34;]; const years = [2024, 2024, 2025, 2025, 2024, 2025]; const amounts = [100, 150, 120, 180, 90, 110]; cells.get(&#34;A1&#34;).putValue(&#34;Fruit&#34;); cells.get(&#34;B1&#34;).putValue(&#34;Year&#34;); cells.get(&#34;C1&#34;).putValue(&#34;Amount&#34;); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">fruits.length</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">0</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">fruits</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">1</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">years</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">2</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">amounts</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="err">}</span> <span class="na">const</span> <span class="na">pivotTable </span><span class="o">=</span> <span class="s">sheet.pivotTables.add(&#34;=A1:C7&#34;,</span> <span class="na">2</span><span class="err">,</span> <span class="na">4</span><span class="err">);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Row</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Fruit</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">calculateData</span><span class="err">();</span> <span class="err">//</span> <span class="na">Ziele</span> <span class="na">das</span> <span class="na">Rechteck</span> <span class="na">F4:F6</span> <span class="err">(</span><span class="na">die</span> <span class="na">Wertzellen</span> <span class="na">ohne</span> <span class="na">die</span> <span class="na">Gesamtsumme</span><span class="err">)</span> <span class="na">const</span> <span class="na">index </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.add();</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(index);</span> <span class="na">const</span> <span class="na">area </span><span class="o">=</span> <span class="s">new</span> <span class="na">CellArea</span><span class="err">();</span> <span class="na">area</span><span class="err">.</span><span class="na">startRow </span><span class="o">=</span> <span class="s">3;</span> <span class="na">area</span><span class="err">.</span><span class="na">startColumn </span><span class="o">=</span> <span class="s">5;</span> <span class="na">area</span><span class="err">.</span><span class="na">endRow </span><span class="o">=</span> <span class="s">5;</span> <span class="na">area</span><span class="err">.</span><span class="na">endColumn </span><span class="o">=</span> <span class="s">5;</span> <span class="na">format</span><span class="err">.</span><span class="na">addCellArea</span><span class="err">(</span><span class="na">area</span><span class="err">);</span> <span class="err">//</span> <span class="na">Regel</span> <span class="na">-</span> <span class="na">kursiv</span> <span class="na">auf</span> <span class="na">hellgelb</span> <span class="na">für</span> <span class="na">Beträge</span> <span class="na">zwischen</span> <span class="na">150</span> <span class="na">und</span> <span class="na">300</span> <span class="na">const</span> <span class="na">conditionIndex </span><span class="o">=</span> <span class="s">format.formatConditions.addCondition(</span> <span class="na">FormatConditionType</span><span class="err">.</span><span class="na">CellValue</span><span class="err">,</span> <span class="na">OperatorType</span><span class="err">.</span><span class="na">Between</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">150</span><span class="err">&#34;,</span> <span class="err">&#34;</span><span class="na">300</span><span class="err">&#34;);</span> <span class="na">const</span> <span class="na">style </span><span class="o">=</span> <span class="s">workbook.createStyle();</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">isItalic </span><span class="o">=</span> <span class="s">true;</span> <span class="na">style</span><span class="err">.</span><span class="na">foregroundColor </span><span class="o">=</span> <span class="s">Color.LightYellow;</span> <span class="na">style</span><span class="err">.</span><span class="na">pattern </span><span class="o">=</span> <span class="s">BackgroundType.Solid;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">conditionIndex</span><span class="err">).</span><span class="na">style </span><span class="o">=</span> <span class="s">style;</span> <span class="na">fs</span><span class="err">.</span><span class="na">writeFileSync</span><span class="err">(&#34;</span><span class="na">PivotConditionalFormatCellArea</span><span class="err">.</span><span class="na">xlsx</span><span class="err">&#34;,</span> <span class="na">workbook</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">));</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Done</span><span class="err">;</span> <span class="na">the</span> <span class="na">rule</span> <span class="na">paints</span> <span class="na">F4</span> <span class="na">and</span> <span class="na">F6</span><span class="err">&#34;);</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><h3 id="ein-semantischer-pivotbereich-mit-pivotareas"><strong>Ein semantischer Pivot‑Bereich mit pivotAreas</strong></h3> <p><code>pivotAreas</code> ist dasselbe semantische Regionsmodell, das die verwandte Seite für statische Stile verwendet. Erzeugen Sie ein <code>PivotArea</code>, wählen Sie ein Feld oder einen Bereich mit <code>select</code> oder <code>selectField</code> aus und fügen Sie es mit <code>pivotAreas.addPivotArea(pivotArea)</code> hinzu. Ein semantischer Bereich bleibt an sein Feld gebunden, sodass das bedingte Format dem Feld folgt, wenn die PivotTable aktualisiert und das Layout verschoben wird. Die Überladung <code>pivotAreas.add(pivotArea)</code> funktioniert weiterhin, ist jedoch als veraltet markiert – bevorzugen Sie <code>addPivotArea</code>.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); const { Workbook, SaveFormat, PivotFieldType, PivotArea, FormatConditionType, OperatorType, Color } = AsposeCells; AsposeCells.onReady().then(() =&gt; { const workbook = new Workbook(); const sheet = workbook.worksheets.get(0); const cells = sheet.cells; const fruits = [&#34;Apple&#34;, &#34;Banana&#34;, &#34;Apple&#34;, &#34;Banana&#34;, &#34;Cherry&#34;, &#34;Cherry&#34;]; const years = [2024, 2024, 2025, 2025, 2024, 2025]; const amounts = [100, 150, 120, 180, 90, 110]; cells.get(&#34;A1&#34;).putValue(&#34;Fruit&#34;); cells.get(&#34;B1&#34;).putValue(&#34;Year&#34;); cells.get(&#34;C1&#34;).putValue(&#34;Amount&#34;); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">fruits.length</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">0</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">fruits</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">1</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">years</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">2</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">amounts</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="err">}</span> <span class="na">const</span> <span class="na">pivotTable </span><span class="o">=</span> <span class="s">sheet.pivotTables.add(&#34;=A1:C7&#34;,</span> <span class="na">2</span><span class="err">,</span> <span class="na">4</span><span class="err">);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Row</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Fruit</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">calculateData</span><span class="err">();</span> <span class="err">//</span> <span class="na">Regel</span> <span class="na">an</span> <span class="na">das</span> <span class="na">Datenfeld</span> <span class="na">Amount</span> <span class="na">als</span> <span class="na">semantische</span> <span class="na">Region</span> <span class="na">anhängen</span> <span class="na">const</span> <span class="na">index </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.add();</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(index);</span> <span class="na">const</span> <span class="na">area </span><span class="o">=</span> <span class="s">new</span> <span class="na">PivotArea</span><span class="err">(</span><span class="na">pivotTable</span><span class="err">);</span> <span class="na">area</span><span class="err">.</span><span class="na">selectField</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">format</span><span class="err">.</span><span class="na">pivotAreas</span><span class="err">.</span><span class="na">addPivotArea</span><span class="err">(</span><span class="na">area</span><span class="err">);</span> <span class="err">//</span> <span class="na">Regel</span> <span class="err">–</span> <span class="na">grauer</span> <span class="na">Text</span> <span class="na">für</span> <span class="na">Beträge</span> <span class="na">unter</span> <span class="na">150</span> <span class="na">const</span> <span class="na">conditionIndex </span><span class="o">=</span> <span class="s">format.formatConditions.addCondition(</span> <span class="na">FormatConditionType</span><span class="err">.</span><span class="na">CellValue</span><span class="err">,</span> <span class="na">OperatorType</span><span class="err">.</span><span class="na">LessThan</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">150</span><span class="err">&#34;,</span> <span class="na">null</span><span class="err">);</span> <span class="na">const</span> <span class="na">style </span><span class="o">=</span> <span class="s">workbook.createStyle();</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">color </span><span class="o">=</span> <span class="s">Color.Gray;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">conditionIndex</span><span class="err">).</span><span class="na">style </span><span class="o">=</span> <span class="s">style;</span> <span class="na">fs</span><span class="err">.</span><span class="na">writeFileSync</span><span class="err">(&#34;</span><span class="na">PivotConditionalFormatPivotArea</span><span class="err">.</span><span class="na">xlsx</span><span class="err">&#34;,</span> <span class="na">workbook</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">));</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Done</span><span class="err">;</span> <span class="na">the</span> <span class="na">rule</span> <span class="na">is</span> <span class="na">attached</span> <span class="na">to</span> <span class="na">the</span> <span class="na">Amount</span> <span class="na">value</span> <span class="na">cells</span><span class="err">&#34;);</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><h2 id="wo-die-regeln-gespeichert-werden-und-wie-sie-einen-neuladevorgang-überstehen"><strong>Wo die Regeln gespeichert werden und wie sie einen Neuladevorgang überstehen</strong></h2> <p>Jeder Aufruf von <code>conditionalFormats.add()</code> fügt ein <code>PivotConditionalFormat</code> zur PivotTable hinzu. Die Bedingungen, ihre Formeln und ihre Formate werden mit der Arbeitsmappe gespeichert – das erneute Öffnen der von Beispiel 1 in Node gespeicherten Datei zeigt dieselbe Regel mit ihrem Typ, Operator und Formel unverändert, und <code>getCellAreas()</code> gibt denselben Bereich zurück. Auf dieser Plattform werden die Eigenschaften <code>type</code> und <code>operator</code> einer Bedingung als numerische Enum‑Werte dargestellt. Einträge, die nie eine Bedingung erhalten haben, werden beim Speichern der Arbeitsmappe verworfen, ähnlich wie Excel ein bedingtes Format ohne Regel entfernt.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); AsposeCells.onReady().then(() =&gt; { // Lade die Datei neu, die im ersten Beispiel geschrieben wurde const workbook = new Workbook(new Uint8Array(fs.readFileSync(&#34;PivotConditionalFormatData.xlsx&#34;))); const pivotTable = workbook.worksheets.get(0).pivotTables.get(0); console.log(&#34;Conditional formats: &#34; + pivotTable.conditionalFormats.count); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">pivotTable.conditionalFormats.count</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(i);</span> <span class="na">for</span> <span class="err">(</span><span class="na">let</span> <span class="na">j </span><span class="o">=</span> <span class="s">0;</span> <span class="na">j</span> <span class="err">&lt;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">count</span><span class="err">;</span> <span class="na">j</span><span class="err">++)</span> <span class="err">{</span> <span class="na">const</span> <span class="na">condition </span><span class="o">=</span> <span class="s">format.formatConditions.get(j);</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Format</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="na">i</span> <span class="err">+</span> <span class="err">&#34;</span><span class="na">:</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="na">condition</span><span class="err">.</span><span class="na">type</span> <span class="err">+</span> <span class="err">&#34;</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="na">condition</span><span class="err">.</span><span class="na">operator</span> <span class="err">+</span> <span class="err">&#34;</span> <span class="na">formula1</span><span class="o">=</span><span class="s">&#34; + condition.formula1); </span><span class="s"> } </span><span class="s"> const areas = format.getCellAreas(); </span><span class="s"> for (const area of areas) </span><span class="s"> console.log(&#34;</span> <span class="na">rows</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">startRow</span> <span class="err">+</span> <span class="na">1</span><span class="err">)</span> <span class="err">+</span> <span class="err">&#34;</span><span class="na">-</span><span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">endRow</span> <span class="err">+</span> <span class="na">1</span><span class="err">)</span> <span class="err">+</span> <span class="err">&#34;,</span> <span class="na">columns</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">startColumn</span> <span class="err">+</span> <span class="na">1</span><span class="err">)</span> <span class="err">+</span> <span class="err">&#34;</span><span class="na">-</span><span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">endColumn</span> <span class="err">+</span> <span class="na">1</span><span class="err">));</span> <span class="err">}</span> <span class="err">//</span> <span class="na">Dies</span> <span class="na">gibt</span> <span class="na">aus:</span> <span class="err">//</span> <span class="na">Bedingte</span> <span class="na">Formate:</span> <span class="na">1</span> <span class="err">//</span> <span class="na">Format</span> <span class="na">0:</span> <span class="na">1</span> <span class="na">2</span> <span class="na">formula1</span><span class="o">=</span><span class="s">=200</span> <span class="err">(</span><span class="na">Typ</span> <span class="na">1 </span><span class="o">=</span> <span class="s">Zellwert,</span> <span class="na">Operator</span> <span class="na">2 </span><span class="o">=</span> <span class="s">GrößerAls)</span> <span class="err">//</span> <span class="na">Zeilen</span> <span class="na">4-7</span><span class="err">,</span> <span class="na">Spalten</span> <span class="na">6-6</span> <span class="err">(</span><span class="na">F4:F7</span><span class="err">,</span> <span class="na">der</span> <span class="na">aufgelöste</span> <span class="na">Datenbereich</span><span class="err">)</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><h2 id="verwandte-artikel"><strong>Verwandte Artikel</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/apply-style-to-pivot-table/">Stil auf Pivot‑Table anwenden</a></li> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/format-part-of-pivot-table/">Teil einer Pivot‑Table formatieren</a></li> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/top-10-show-or-filter-in-pivot-table/">Top‑10 anzeigen oder filtern in Pivot‑Table</a></li> <li><a href="https://docs.aspose.com/cells/cells/de/javascript-cpp/filter-by-label-or-value-of-pivot-table/">Pivot‑Table nach Beschriftung oder Wert filtern</a></li> </ul> <button class="floating-button" id="openModalBtn">AI Document Assistant</button> <div class="modal" id="modal"> <button class="close-btn" id="closeModalBtn">Close</button> <iframe src="https://products.aspose.ai/cells/chat/document/javascript-cpp?source=docs" frameborder="0" width="100%" height="100%"></iframe> </div> <style> .floating-button { position: fixed; bottom: 20px; right: 20px; background-color: #007bff; color: white; border: none; padding: 15px 20px; border-radius: 50px; cursor: pointer; font-size: 16px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2); z-index: 999; } .modal { display: none; position: fixed; top: 10%; left: 10%; width: 80%; height: 80%; background-color: white; border: none; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3); z-index: 1000; padding: 20px; box-sizing: border-box; } .close-btn { position: absolute; top: 10px; right: 10px; background-color: #f44336; color: white; border: none; padding: 5px 10px; cursor: pointer; font-size: 16px; border-radius: 3px; } </style> <script> const openModalBtn = document.getElementById('openModalBtn'); const closeModalBtn = document.getElementById('closeModalBtn'); const modal = document.getElementById('modal'); openModalBtn.addEventListener('click', function() { modal.style.display = 'block'; }); closeModalBtn.addEventListener('click', function() { modal.style.display = 'none'; }); window.addEventListener('click', function(event) { if (event.target === modal) { modal.style.display = 'none'; } }); </script>