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.