Applicare una sfumatura alle righe e alle colonne alternate con la formattazione condizionale

Le API di Aspose.Cells forniscono i mezzi per aggiungere e manipolare regole di formattazione condizionale per l’oggetto Worksheet. Queste regole possono essere adattate in vari modi per ottenere la formattazione desiderata in base alle condizioni o alle regole. Questo articolo dimostrerà l’uso delle API Aspose.Cells for Node.js via C++ per applicare ombreggiature alle righe e colonne alternate con l’aiuto di regole di formattazione condizionale e funzioni integrate di Excel.

Questo articolo fa uso di funzioni integrate di Excel come ROW, COLUMN e MOD. Ecco alcuni dettagli di queste funzioni per una migliore comprensione dello snippet di codice fornito in seguito.

• La funzione ROW() restituisce il numero di riga di un riferimento di cella. Se si omette il parametro reference, si assume che il riferimento sia l’indirizzo della cella in cui è stato inserito il funzione ROW.
• La funzione COLUMN() restituisce il numero di colonna di un riferimento di cella. Se si omette il parametro reference, si assume che il riferimento sia l’indirizzo della cella in cui è stato inserito il funzione COLUMN.
• La funzione MOD() restituisce il resto dopo che un numero è diviso per un divisore, dove il primo parametro della funzione è il valore numerico di cui si desidera trovare il resto e il secondo parametro è il numero utilizzato per dividere il parametro del numero. Se il divisore è 0, restituirà l’errore #DIV/0!.

Iniziamo a scrivere del codice per raggiungere questo obiettivo con l’aiuto dell’API Aspose.Cells for Node.js via C++.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create an instance of Workbook or load existing
const book = new AsposeCells.Workbook();

// Access the Worksheet on which desired rule has to be applied
const sheet = book.getWorksheets().get(0);

// Add FormatConditions to the instance of Worksheet
let idx = sheet.getConditionalFormattings().add();

// Access the newly added FormatConditions via its index
const conditionCollection = sheet.getConditionalFormattings().get(idx);

// Define a CellsArea on which conditional formatting will be applicable
// The code creates a CellArea ranging from A1 to I20
const area = AsposeCells.CellArea.createCellArea("A1", "I20");

// Add area to the instance of FormatConditions
conditionCollection.addArea(area);

// Add a condition to the instance of FormatConditions
// For this case, the condition type is expression, which is based on some formula
idx = conditionCollection.addCondition(AsposeCells.FormatConditionType.Expression);

// Access the newly added FormatCondition via its index
const formatCondition = conditionCollection.get(idx);

// Set the formula for the FormatCondition
formatCondition.setFormula1("=MOD(ROW(),2)=0");

// Set the background color and pattern for the FormatCondition's Style
formatCondition.getStyle().setBackgroundColor(AsposeCells.Color.Blue);
formatCondition.getStyle().setPattern(AsposeCells.BackgroundType.Solid);

// Save the result on disk
book.save(path.join(dataDir, "output_out.xlsx"));

Il seguente screenshot mostra il foglio elettronico caricato nell’applicazione Excel.

Per applicare l’ombreggiatura alle colonne alternative, tutto ciò che devi fare è modificare la formula =MOD(FILA(),2)=0 in =MOD(COLONNA(),2)=0, cioè; invece di ottenere l’indice di riga, modifica la formula per recuperare l’indice di colonna.
Il foglio elettronico risultante, in questo caso, avrà questo aspetto.