Paramètres de bordure
Ajout de bordures aux cellules
Microsoft Excel permet aux utilisateurs de formater des cellules en ajoutant des bordures. Le type de bordure dépend de l’emplacement où elle est ajoutée. Par exemple, une bordure supérieure est ajoutée à la position supérieure d’une cellule. Les utilisateurs peuvent également modifier le style de ligne et la couleur des bordures.
Avec Aspose.Cells pour Python via .NET, les développeurs peuvent ajouter des bordures et personnaliser leur apparence de la même manière flexible qu’avec Microsoft Excel.
Ajout de bordures aux cellules
Aspose.Cells pour Python via .NET fournit une classe, Workbook qui représente un fichier Microsoft Excel. La classe Workbook contient une collection worksheets qui permet d’accéder à chaque feuille de calcul du fichier Excel. Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet fournit la collection Cells. Chaque élément de la collection Cells représente un objet de la classe Cell.
Aspose.Cells pour Python via .NET fournit la méthode get_style dans la classe Cell. La méthode set_style est utilisée pour définir le style de mise en forme d’une cellule. La classe Style fournit des propriétés pour ajouter des bordures aux cellules.
Ajout de bordures à une cellule
Les développeurs peuvent ajouter des bordures à une cellule en utilisant la collection borders de l’objet Style. Le type de bordure est passé en index à la collection borders. Tous les types de bordures sont prédéfinis dans l’énumération BorderType.
Énumération de bordure
| Types de bordures | Description |
|---|---|
| BORDURE_INFÉRIEURE | Une ligne de bordure en bas |
| DIAGONALE_DESCENDANTE | Une ligne diagonale du haut gauche vers le bas droit |
| DIAGONALE_MONTE | Une ligne diagonale du bas gauche vers le haut droit |
| BORDURE_GAUCHE | Une ligne de bordure à gauche |
| BORDURE_DROITE | Une ligne de bordure à droite |
| BORDURE_SUPÉRIEURE | Une ligne de bordure en haut |
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.
Pour définir la couleur de la ligne de bordure, sélectionnez une couleur à l’aide de l’énumération Couleur (partie du cadre .NET) et attribuez-la à la propriété Couleur de l’objet Bordure.
Le style de la ligne de la bordure est défini en sélectionnant un style de ligne à partir de l’énumération CellBorderType.
Énumération de Type de Bordure Cellulaire
| Styles de ligne | Description |
|---|---|
| TIRET_POINT | Ligne pointillée fine |
| TIRET_POINT_POINT | Ligne tiret-point fin |
| TACHÉ | Ligne tachetée |
| POINTILLÉ | Ligne pointillée |
| DOUBLE | Ligne double |
| CHEVEUX | Ligne très fine |
| TIRET_MOYEN_DASH_DOT | Ligne pointillée moyenne diagonale |
| TIRET_MOYEN_DASH_DOT_DOT | Ligne tiret-point moyenne pointillée |
| TIRET_MOYEN_DÉCHETÉ | Ligne tiret m-tière moyenne |
| AUCUN | Pas de ligne |
| MOYEN | Ligne moyenne |
| DIAGONALE_ENCOLLÉE_DASH_DOT | Ligne diagonale oblique tiret-point |
| ÉPAISSE | Ligne épaisse |
| FAINTE | Ligne fine |
| Sélectionnez l’un des styles de ligne, puis affectez-le à la propriété line_style de l’objet 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") |
Ajout de bordures à une plage de cellules
Il est également possible d’ajouter des bordures à une plage de cellules plutôt qu’à une seule cellule. Pour ce faire, créez d’abord une plage de cellules en appelant la méthode create_range de la collection Cells. Elle prend les paramètres suivants :
- Première ligne, la première ligne de la plage.
- Première colonne, represente la première colonne de la plage.
- Nombre de lignes, le nombre de lignes dans la plage.
- Nombre de colonnes, le nombre de colonnes dans la plage.
La méthode create_range renvoie un objet Range, qui contient la plage de cellules spécifiée. L’objet Range fournit une méthode set_outline_border qui prend les paramètres suivants pour ajouter une bordure à la plage de cellules :
- Type de bordure, le type de bordure, sélectionné dans l’énumération BorderType.
- Style de ligne, le style de la bordure, sélectionné dans l’énumération CellBorderType.
- Couleur, la couleur de la ligne, sélectionnée dans l’énumération Color.
| 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") |