Impostazioni bordo
Aggiungere Bordi alle Celle
Microsoft Excel consente agli utenti di formattare le celle aggiungendo dei bordi. Il tipo di bordo dipende da dove viene aggiunto. Ad esempio, un bordo superiore è quello aggiunto alla posizione superiore di una cella. Gli utenti possono anche modificare lo stile della linea e il colore dei bordi.
Con Aspose.Cells per Python via .NET, gli sviluppatori possono aggiungere bordi e personalizzarli nello stesso modo flessibile di Microsoft Excel.
Aggiungere Bordi alle Celle
Aspose.Cells per Python via .NET fornisce una classe, Workbook che rappresenta un file Microsoft Excel. La classe Workbook contiene una collezione worksheets che consente l’accesso a ogni foglio di lavoro nel file Excel. Un foglio di lavoro è rappresentato dalla classe Worksheet. La classe Worksheet fornisce la collezione Cells. Ogni elemento nella collezione Cells rappresenta un oggetto della classe Cell.
Aspose.Cells per Python via .NET fornisce il metodo get_style nella classe Cell. Il metodo set_style viene usato per impostare lo stile di formattazione di una cella. La classe Style fornisce proprietà per aggiungere bordi alle celle.
Aggiunta di bordi a una cella
Gli sviluppatori possono aggiungere bordi a una cella utilizzando la collezione Style dell’oggetto borders. Il tipo di bordo viene passato come indice alla collezione borders. Tutti i tipi di bordi sono predefiniti nell’enumerazione BorderType.
Enumerazione Border
| Tipi di bordi | Descrizione |
|---|---|
| BOTTOM_BORDER | Una linea di bordo inferiore |
| DIAGONAL_DOWN | Una linea diagonale dalla parte superiore sinistra a quella inferiore destra |
| DIAGONAL_UP | Una linea diagonale dalla parte inferiore sinistra a quella superiore destra |
| LEFT_BORDER | Una linea di bordo sinistra |
| RIGHT_BORDER | Una linea di bordo destra |
| TOP_BORDER | Una linea di bordo superiore |
The borders collection stores all borders. Each border in the Borders collection is represented by a Border object which provides two properties, color and line_style to set a border’s line color and style respectively.
Per impostare il colore della linea del bordo, selezionare un colore utilizzando l’enumerazione Colore (parte del Framework .NET) e assegnarlo alla proprietà Colore dell’oggetto Bordo.
Lo stile della linea del bordo viene impostato selezionando uno stile di linea dall’enumerazione CellBorderType.
Enumerazione CellBorderType
| Stili di linea | Descrizione |
|---|---|
| DASH_DOT | Linea sottile tratteggiata-puntinata |
| DASH_DOT_DOT | Linea sottile tratteggiata-puntinata doppia |
| DASHED | Linea tratteggiata |
| DOTTED | Linea punteggiata |
| DOUBLE | Linea doppia |
| HAIR | Linea sottile |
| MEDIUM_DASH_DOT | Linea tratteggiata media |
| MEDIUM_DASH_DOT_DOT | Linea tratteggiata-doppia media |
| MEDIUM_DASHED | Linea tratteggiata media |
| NONE | Nessuna linea |
| MEDIUM | Linea media |
| SLANTED_DASH_DOT | Linea tratteggiata obliqua media |
| THICK | Linea spessa |
| THIN | Linea sottile |
| Seleziona uno degli stili di linea e poi assegnalo alla proprietà line_style dell’oggetto Border. |
| from aspose.cells import BorderType, CellBorderType, Workbook | |
| from aspose.pydrawing import Color | |
| from os import os, path | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Create directory if it is not already present. | |
| IsExists = path.isdir(dataDir) | |
| if notIsExists: | |
| os.makedirs(dataDir) | |
| # Instantiating a Workbook object | |
| workbook = Workbook() | |
| # Obtaining the reference of the first (default) worksheet by passing its sheet index | |
| worksheet = workbook.worksheets[0] | |
| # Accessing the "A1" cell from the worksheet | |
| cell = worksheet.cells.get("A1") | |
| # Adding some value to the "A1" cell | |
| cell.put_value("Visit Aspose!") | |
| # Create a style object | |
| style = cell.get_style() | |
| # Setting the line style of the top border | |
| style.borders.get(BorderType.TOP_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the top border | |
| style.borders.get(BorderType.TOP_BORDER).color = Color.black | |
| # Setting the line style of the bottom border | |
| style.borders.get(BorderType.BOTTOM_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the bottom border | |
| style.borders.get(BorderType.BOTTOM_BORDER).color = Color.black | |
| # Setting the line style of the left border | |
| style.borders.get(BorderType.LEFT_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the left border | |
| style.borders.get(BorderType.LEFT_BORDER).color = Color.black | |
| # Setting the line style of the right border | |
| style.borders.get(BorderType.RIGHT_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the right border | |
| style.borders.get(BorderType.RIGHT_BORDER).color = Color.black | |
| # Apply the border styles to the cell | |
| cell.set_style(style) | |
| # Saving the Excel file | |
| workbook.save(dataDir + "book1.out.xls") |
Aggiunta di bordi a un intervallo di celle
È anche possibile aggiungere bordi a un intervallo di celle anziché a una singola cella. Per farlo, prima crea un intervallo di celle chiamando il metodo create_range della collezione Cells. Richiede 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 create_range restituisce un oggetto Range, che contiene l’intervallo specificato di celle. L’oggetto Range fornisce un metodo set_outline_border che accetta i seguenti parametri per aggiungere un bordo all’intervallo di celle:
- Tipo di bordo, il tipo di bordo, selezionato dall’enumerazione BorderType.
- Stile di linea, lo stile di linea del bordo, selezionato dall’enumerazione CellBorderType.
- Colore, il colore della linea, selezionato dall’enumerazione Colore.
| from aspose.cells import BorderType, CellBorderType, Workbook | |
| from aspose.pydrawing import Color | |
| from os import os, path | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Create directory if it is not already present. | |
| IsExists = path.isdir(dataDir) | |
| if notIsExists: | |
| os.makedirs(dataDir) | |
| # Instantiating a Workbook object | |
| workbook = Workbook() | |
| # Obtaining the reference of the first (default) worksheet by passing its sheet index | |
| worksheet = workbook.worksheets[0] | |
| # Accessing the "A1" cell from the worksheet | |
| cell = worksheet.cells.get("A1") | |
| # Adding some value to the "A1" cell | |
| cell.put_value("Hello World From Aspose") | |
| # Creating a range of cells starting from "A1" cell to 3rd column in a row | |
| range = worksheet.cells.create_range(0, 0, 1, 3) | |
| # Adding a thick top border with blue line | |
| range.set_outline_border(BorderType.TOP_BORDER, CellBorderType.THICK, Color.blue) | |
| # Adding a thick bottom border with blue line | |
| range.set_outline_border(BorderType.BOTTOM_BORDER, CellBorderType.THICK, Color.blue) | |
| # Adding a thick left border with blue line | |
| range.set_outline_border(BorderType.LEFT_BORDER, CellBorderType.THICK, Color.blue) | |
| # Adding a thick right border with blue line | |
| range.set_outline_border(BorderType.RIGHT_BORDER, CellBorderType.THICK, Color.blue) | |
| # Saving the Excel file | |
| workbook.save(dataDir + "book1.out.xls") |