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, les développeurs peuvent ajouter des bordures et personnaliser leur aspect de la même manière flexible que dans Microsoft Excel.
Ajout de bordures aux cellules
Aspose.Cells 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 fournit la méthode GetStyle dans la classe Cell. La méthode SetStyle est utilisée pour définir le style de formatage 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 |
|---|---|
| BottomBorder | Une ligne de bordure inférieure |
| DiagonalDown | Une ligne diagonale de haut gauche à bas droite |
| DiagonalUp | Une ligne diagonale de bas gauche à haut droit |
| LeftBorder | Une ligne de bordure gauche |
| RightBorder | Une ligne de bordure droite |
| TopBorder | Une ligne de bordure supérieure |
The Borders collection stores all borders. Each border in the Borders collection is represented by a Border object which provides two properties, Color and LineStyle 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 |
|---|---|
| DashDot | Ligne pointillée fine |
| DashDotDot | Ligne pointillée fine avec point |
| Dashed | Ligne en tirets |
| Dotted | Ligne en pointillés |
| Double | Ligne double |
| Hair | Ligne fine |
| MediumDashDot | Ligne mixte pointillée |
| MediumDashDotDot | Ligne mixte pointillée-traitée |
| MediumDashed | Ligne en pointillés moyens |
| None | Aucune ligne |
| Medium | Ligne moyenne |
| SlantedDashDot | Ligne mixte pointillée inclinée moyenne |
| Thick | Ligne épaisse |
| Thin | Ligne fine |
| Sélectionnez l’un des styles de ligne, puis affectez-le à la propriété LineStyle de l’objet Border. |
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 CreateRange 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 CreateRange renvoie un objet Range, qui contient la plage de cellules spécifiée. L’objet Range fournit une méthode SetOutlineBorder 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.