Impostazioni bordo

Aggiungere Bordi alle Celle

Microsoft Excel permette agli utenti di formattare le celle aggiungendo i bordi. Il tipo di bordo dipende da dove viene aggiunto. Ad esempio, un bordo superiore viene aggiunto alla posizione superiore di una cella. Gli utenti possono anche modificare lo stile di linea e il colore dei bordi.

Con Aspose.Cells for Node.js via C++, gli sviluppatori possono aggiungere bordi e personalizzarli come fanno in modo flessibile in Microsoft Excel.

Aggiungere Bordi alle Celle

Aspose.Cells fornisce una classe, Workbook che rappresenta un file Microsoft Excel. La classe Workbook contiene una collezione worksheets che consente di accedere a ogni foglio di calcolo nel file Excel. Un foglio di calcolo viene rappresentato dalla classe Worksheet. La classe Worksheet fornisce la collezione cells. Ogni elemento nella collezione cells rappresenta un oggetto della classe Cell.

Aspose.Cells fornisce il metodo getStyle nella classe Cell. Il metodo setStyle viene utilizzato per impostare lo stile di formattazione di una cella. La classe Style offre proprietà per aggiungere bordi alle celle.

Aggiunta di bordi a una cella

Gli sviluppatori possono aggiungere bordi a una cella utilizzando la raccolta Style dell’oggetto borders. Il tipo di bordo viene passato come indice alla raccolta borders. Tutti i tipi di bordo sono predefiniti nell’enumerazione BorderType.

Enumerazione Border

Tipi di bordi	Descrizione
BottomBorder	Una linea di bordo inferiore
DiagonalDown	Una linea diagonale dall’angolo in alto a sinistra all’angolo in basso a destra
DiagonalUp	Una linea diagonale dall’angolo in basso a sinistra all’angolo in alto a destra
LeftBorder	Una linea di bordo sinistro
RightBorder	Una linea di bordo destro
TopBorder	Una linea di bordo superiore

La raccolta borders memorizza tutti i bordi. Ogni bordo nella raccolta borders è rappresentato da un oggetto Border che fornisce due proprietà, setColor e setLineStyle, per impostare rispettivamente colore e stile della linea del bordo.

Per impostare il colore della linea del bordo, seleziona un colore usando l’enumerazione Color (parte di Node.js) e assegnalo alla proprietà color dell’oggetto Border.

Lo stile della linea del bordo viene impostato selezionando uno stile di linea dall’enumerazione CellBorderType.

Enumerazione CellBorderType

Stili di linea	Descrizione
DashDot	Linea tratteggiata sottile a punti
DashDotDot	Linea sottile a punti e trattini
Dashed	Linea tratteggiata
Dotted	Linea a punti
Double	Linea doppia
Hair	Linea sottilissima
MediumDashDot	Linea media tratteggiata a punti
MediumDashDotDot	Linea media a punti e trattini
MediumDashed	Linea tratteggiata media
None	Nessuna linea
Medium	Linea media
SlantedDashDot	Linea tratteggiata sottile a punti inclinata
Thick	Linea spessa
Thin	Linea sottile
Seleziona uno degli stili di linea e assegnalo alla proprietà lineStyle dell’oggetto Border.

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

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

// Create directory if it is not already present.
if (!require("fs").existsSync(dataDir)) {
    require("fs").mkdirSync(dataDir);
}

// Instantiating a Workbook object
const workbook = new AsposeCells.Workbook();

// Obtaining the reference of the first (default) worksheet by passing its sheet index
const worksheet = workbook.getWorksheets().get(0);

// Accessing the "A1" cell from the worksheet
const cell = worksheet.getCells().get("A1");

// Adding some value to the "A1" cell
cell.putValue("Visit Aspose!");

// Create a style object
const style = cell.getStyle();

// Setting the line style of the top border
style.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thick);

// Setting the color of the top border
style.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);

// Setting the line style of the bottom border
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thick);

// Setting the color of the bottom border
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);

// Setting the line style of the left border
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thick);

// Setting the color of the left border
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);

// Setting the line style of the right border
style.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thick);

// Setting the color of the right border
style.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);

// Apply the border styles to the cell
cell.setStyle(style);

// Saving the Excel file
workbook.save(path.join(dataDir, "book1.out.xls"));

Dovresti impostare sia lo stile di linea che il colore contemporaneamente. Le due linee diagonali del bordo dovrebbero avere lo stesso stile e colore.

Aggiunta di bordi a un intervallo di celle

È anche possibile aggiungere bordi a un intervallo di celle piuttosto che a una singola cella. Per farlo, prima crea un intervallo di celle chiamando il metodo createRange della raccolta cells. Accetta i seguenti parametri:

• Prima riga, la prima riga dell’intervallo.
• Prima colonna, rappresenta la prima colonna dell’intervallo.
• Numero di righe, il numero di righe nell’intervallo.
• Numero di colonne, il numero di colonne nell’intervallo.

Il metodo createRange restituisce un oggetto Range, che contiene l’intervallo di celle specificato. L’oggetto Range fornisce un metodo setOutlineBorder che prende i seguenti parametri per aggiungere un bordo all’intervallo di celle:

• Tipo di Bordi, il tipo di bordo, selezionato dall’enumerazione BorderType.
• Stile di Linea, lo stile della linea del bordo, selezionato dall’enumerazione CellBorderType.
• Colore, il colore della linea, selezionato dall’enumerazione Colore.

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

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

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)){
    fs.mkdirSync(dataDir);
}

// Instantiating a Workbook object
const workbook = new AsposeCells.Workbook();

// Obtaining the reference of the first (default) worksheet by passing its sheet index
const worksheet = workbook.getWorksheets().get(0);

// Accessing the "A1" cell from the worksheet
const cell = worksheet.getCells().get("A1");

// Adding some value to the "A1" cell
cell.putValue("Hello World From Aspose");

// Creating a range of cells starting from "A1" cell to 3rd column in a row
const range = worksheet.getCells().createRange(0, 0, 1, 3);

// Adding a thick top border with blue line
range.setOutlineBorder(AsposeCells.BorderType.TopBorder, AsposeCells.CellBorderType.Thick, AsposeCells.Color.Blue);

// Adding a thick bottom border with blue line
range.setOutlineBorder(AsposeCells.BorderType.BottomBorder, AsposeCells.CellBorderType.Thick, AsposeCells.Color.Blue);

// Adding a thick left border with blue line
range.setOutlineBorder(AsposeCells.BorderType.LeftBorder, AsposeCells.CellBorderType.Thick, AsposeCells.Color.Blue);

// Adding a thick right border with blue line
range.setOutlineBorder(AsposeCells.BorderType.RightBorder, AsposeCells.CellBorderType.Thick, AsposeCells.Color.Blue);

// Saving the Excel file
workbook.save(path.join(dataDir, "book1.out.xls"));