Paramètres de remplissage
Couleurs et motifs d’arrière-plan
Microsoft Excel peut définir les couleurs avant-plan (contour) et arrière-plan (remplissage) des cellules et les motifs d’arrière-plan.
Aspose.Cells pour Python via .NET supporte également ces fonctionnalités de manière flexible. Dans ce sujet, nous apprenons à utiliser ces fonctionnalités avec Aspose.Cells.
Définition de couleurs et motifs d’arrière-plan
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 dans le fichier Excel. Une feuille est représentée par la classe Worksheet. La classe Worksheet fournit une collection Cells. Chaque élément de la collection Cells représente un objet de la classe Cell.
La méthode Cell et get_style permettent de récupérer et de définir la mise en forme d’une cellule. La classe Style fournit des propriétés pour définir les couleurs de premier plan et d’arrière-plan des cellules. Aspose.Cells pour Python via .NET offre une énumération BackgroundType qui contient un ensemble de types de motifs de fond prédéfinis, listés ci-dessous.
| Motifs d’arrière-plan | Description |
|---|---|
| DIAGONAL_CROSSHATCH | Représente un motif de croisillons diagonaux |
| DIAGONAL_STRIPE | Représente un motif de rayures diagonales |
| GRAY6 | Représente le motif de gris à 6,25% |
| GRAY12 | Représente le motif de gris à 12,5% |
| GRAY25 | Représente le motif de gris à 25% |
| GRAY50 | Représente le motif de gris à 50% |
| GRAY75 | Représente le motif de gris à 75% |
| HORIZONTAL_STRIPE | Représente le motif de rayures horizontales |
| NONE | Représente l’absence de fond |
| REVERSE_DIAGONAL_STRIPE | Représente le motif de rayures diagonales inversées |
| SOLID | Représente un motif plein |
| THICK_DIAGONAL_CROSSHATCH | Représente le motif de hachures croisées diagonales épaisses |
| THIN_DIAGONAL_CROSSHATCH | Représente le motif de hachures croisées diagonales fines |
| THIN_DIAGONAL_STRIPE | Représente le motif de rayures diagonales fines |
| THIN_HORIZONTAL_CROSSHATCH | Représente le motif de hachures horizontales fines |
| THIN_HORIZONTAL_STRIPE | Représente le motif de rayures horizontales fines |
| THIN_REVERSE_DIAGONAL_STRIPE | Représente le motif de rayures diagonales inversées fines |
| THIN_VERTICAL_STRIPE | Représente le motif de rayures verticales fines |
| VERTICAL_STRIPE | Représente le motif de rayures verticales |
Dans l’exemple ci-dessous, la couleur de premier plan de la cellule A1 est définie, mais A2 est configurée pour avoir à la fois des couleurs de premier plan et d’arrière-plan avec un motif d’arrière-plan de rayures verticales.|
Important à savoir
- Pour définir la couleur d’avant-plan ou d’arrière-plan d’une cellule, utilisez les propriétés foreground_color ou background_color de l’objet Style. Ces deux propriétés prendront effet seulement si la propriété Style de l’objet pattern est configurée.
- La propriété foreground_color définit la couleur d’ombrage de la cellule. La propriété pattern spécifie le type de motif de fond utilisé pour la couleur de l’avant-plan ou de l’arrière-plan. Aspose.Cells pour Python via .NET fournit une énumération, BackgroundType, qui contient un ensemble de types de motifs de fond prédéfinis.
- Si vous sélectionnez la valeur BackgroundType.None de l’énumération BackgroundType, la couleur d’avant-plan n’est pas appliquée. De même, la couleur d’arrière-plan n’est pas appliquée si vous sélectionnez les valeurs BackgroundType.None ou BackgroundType.Solid.
- Lors de la récupération de la couleur d’ombrage/remplissage d’une cellule, si Style.pattern est BackgroundType.None, Style.foreground_color renverra Color.Empty.
Application d’effets de remplissage dégradé
Pour appliquer vos effets de remplissage dégradé souhaités à la cellule, utilisez la méthode set_two_color_gradient de l’objet Style en conséquence.
Couleurs et palette
Une palette est le nombre de couleurs disponibles pour créer une image. L’utilisation d’une palette normalisée dans une présentation permet à l’utilisateur de créer un aspect cohérent. Chaque fichier Microsoft Excel (97-2003) possède une palette de 56 couleurs qui peuvent être appliquées aux cellules, polices, quadrillages, objets graphiques, remplissages et lignes dans un graphique.
Avec Aspose.Cells pour Python via .NET, il est possible non seulement d’utiliser les couleurs existantes de la palette, mais aussi des couleurs personnalisées. Avant d’utiliser une couleur personnalisée, ajoutez-la d’abord à la palette.
Ce sujet traite de l’ajout de couleurs personnalisées à la palette.
Ajout de couleurs personnalisées à la palette
Aspose.Cells pour Python via .NET prend en charge la palette de 56 couleurs de Microsoft Excel. Pour utiliser une couleur personnalisée non définie dans la palette, ajoutez-la à la palette.
Aspose.Cells pour Python via .NET fournit une classe, Workbook, qui représente un fichier Microsoft Excel. La classe Workbook fournit une méthode change_palette qui prend les paramètres suivants pour ajouter une couleur personnalisée afin de modifier la palette :
- Couleur personnalisée, la couleur personnalisée à ajouter.
- Index, l’index de la couleur dans la palette que la couleur personnalisée remplacera. Doit être compris entre 0 et 55.
L’exemple ci-dessous ajoute une couleur personnalisée (Orchid) à la palette avant de l’appliquer sur une police.