Paramètres de bordure
Ajout de bordures aux cellules
Microsoft Excel permet aux utilisateurs de formater les cellules en ajoutant des bordures. Le type de bordure dépend de l’endroit où elle est ajoutée. Par exemple, une bordure supérieure est celle ajoutée en haut d’une cellule. Les utilisateurs peuvent également modifier le style de ligne et la couleur des bordures.
Avec Aspose.Cells for Node.js via C++, les développeurs peuvent ajouter des bordures et personnaliser leur apparence 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 dans le fichier Excel. Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet fournit la collection cells. Chaque élément dans 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 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é comme un 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 |
La collection borders stocke toutes les bordures. Chaque bordure dans la collection borders est représentée par un objet Border qui fournit deux propriétés, setColor et setLineStyle pour définir respectivement la couleur et le style de la ligne d’une bordure.
Pour définir la couleur de la ligne d’une bordure, choisissez une couleur en utilisant l’énumération Color (partie de Node.js) et assignez-la à la propriété color de l’objet Border.
Le style de ligne de la bordure est défini en sélectionnant un style de ligne dans 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 assignez-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 accepte les paramètres suivants pour ajouter une bordure à cette plage de cellules :
- Type de Bordure, le type de bordure, sélectionné dans l’énumération BorderType.
- Style de Ligne, le style de ligne de la bordure, sélectionné dans l’énumération CellBorderType.
- Couleur, la couleur de la ligne, sélectionnée dans l’énumération Color.