Style — Aspose.Cells FOSS for Python API Reference

Examples Style la classe et ses types compagnons contrôlent tout le formatage visuel et protecteur appliqué aux cellules dans aspose-cells-foss. A Style l’objet est obtenu à partir d’une cellule via cell.get_style() et réappliqué avec cell.apply_style(style).

Examples: aspose.cells_foss

from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, Protection

Examples

Examples

Style()

Crée un format par défaut Style avec aucun formatage explicite appliqué.

Examples

Examples

copier

style.copy() -> Style

Renvoie une copie profonde de cet objet style.

set_fill_color

style.set_fill_color(color: str)

Définit la couleur d’arrière-plan du remplissage uni. color est une chaîne hexadécimale RRGGBB (p. ex., "FFFF00" pour le jaune).

set_fill_pattern

style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')

Définit un remplissage à motif. pattern_type les valeurs incluent 'solid', 'darkGray', 'mediumGray', 'lightGray', 'gray125', 'gray0625', 'darkHorizontal', 'darkVertical', 'darkDown', 'darkUp', 'darkGrid', 'darkTrellis', 'lightHorizontal', 'lightVertical', 'lightDown', 'lightUp', 'lightGrid', 'lightTrellis'.

set_no_fill

style.set_no_fill()

Supprime tout remplissage, définissant l’arrière-plan de la cellule comme transparent (pas de remplissage).

set_border_color

style.set_border_color(side: str, color: str)

Définit la couleur d’un seul côté de bordure. side doit être l’une des 'top', 'bottom', 'left', 'right', 'diagonal'. color est une chaîne hexadécimale RRGGBB.

set_border_style

style.set_border_style(side: str, style: str)

Définit le style de ligne d’un côté de la bordure. style valeurs : 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.

set_border_weight

style.set_border_weight(side: str, weight: int)

Définit l’épaisseur (épaisseur) de la ligne d’un côté de la bordure sous forme d’entier.

set_border

style.set_border(side: str, line_style='none', color='FF000000', weight=1)

Méthode pratique qui définit le style de ligne, la couleur et l’épaisseur pour un seul côté de la bordure en un seul appel.

set_diagonal_border

style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)

Définit la bordure diagonale. Passez up=True pour une diagonale ascendante, down=True pour une diagonale descendante, ou les deux pour dessiner une croix.

set_horizontal_alignment

style.set_horizontal_alignment(alignment: str)

Définit l’alignement horizontal du texte. Valeurs : 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.

set_vertical_alignment

style.set_vertical_alignment(alignment: str)

Définit l’alignement vertical du texte. Valeurs : 'top', 'center', 'bottom', 'justify', 'distributed'.

set_text_wrap

style.set_text_wrap(wrap=True)

Active ou désactive le retour à la ligne du texte à l’intérieur de la cellule.

set_shrink_to_fit

style.set_shrink_to_fit(shrink=True)

Active ou désactive le rétrécissement pour ajuster. Lorsqu’il est activé, le texte est réduit pour s’adapter à la largeur de la cellule.

set_indent

style.set_indent(indent: int)

Définit le niveau d’indentation (0–15).

set_text_rotation

style.set_text_rotation(rotation: int)

Définit la rotation du texte en degrés. Les valeurs valides sont 0–180 (dans le sens anti‑horaire à partir de 0°) ou 255 (texte vertical empilé de haut en bas).

set_reading_order

style.set_reading_order(order: int)

Définit l’ordre de lecture. 0 = dépend du contexte, 1 = de gauche à droite, 2 = de droite à gauche.

set_number_format

style.set_number_format(format_code: str)

Applique une chaîne de format numérique personnalisée (p. ex., "DD/MM/YYYY", "#,##0.00 [$€-407]").

set_builtin_number_format

style.set_builtin_number_format(format_id: int)

Applique l’un des formats numériques intégrés d’Excel par son ID entier (p. ex., 9 = "0%", 14 = "m/d/yy").

set_locked

style.set_locked(locked=True)

Marque la cellule comme verrouillée. Les cellules verrouillées ne peuvent pas être modifiées lorsque la protection de la feuille de calcul est active.

set_formula_hidden

style.set_formula_hidden(hidden=True)

Masque les formules de la barre de formule lorsque la protection de la feuille de calcul est active.

Examples

Examples

Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)

Examples

Examples

Examples

Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')

Examples

Examples

set_solid_fill

fill.set_solid_fill(color: str)

Applique un remplissage uni avec la couleur RRGGBB fournie.

set_gradient_fill

fill.set_gradient_fill(start_color: str, end_color: str)

Applique un remplissage en dégradé à deux couleurs.

set_pattern_fill

fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)

Applique un remplissage à motif avec des couleurs de premier plan et d’arrière-plan explicites.

set_no_fill

fill.set_no_fill()

Supprime tout remplissage de la cellule.

Examples

Examples

Border(line_style='none', color='FF000000', weight=1)

Examples

Examples

Examples

Borders()

Un conteneur pour les quatre bordures de cellule ainsi que les bordures diagonales.

Examples

Examples

Examples

Alignment(horizontal='general', vertical='bottom', wrap_text=False, indent=0, text_rotation=0, shrink_to_fit=False)

Examples

NumberFormat

NumberFormat est une classe utilitaire avec uniquement des méthodes statiques. Elle n’est pas instanciée directement.

Méthodes statiques

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

Renvoie la chaîne du code de format pour l’ID de format intégré donné (par ex., NumberFormat.get_builtin_format(9) renvoie "0%").

is_builtin_format

NumberFormat.is_builtin_format(format_code: str) -> bool

Examples True si le code de format fourni correspond à un format Excel intégré connu.

lookup_builtin_format

NumberFormat.lookup_builtin_format(format_code: str) -> int | None

Renvoie l’ID du format intégré pour une chaîne de code de format, ou None si le code n’est pas un format intégré.

Examples

Examples

Protection(locked=True, hidden=False)

Examples

Examples

L’exemple suivant applique un style à une cellule d’en-tête avec du texte rouge en gras, un arrière-plan jaune et une fine bordure noire sur tous les côtés.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["A1"].put_value("Total Revenue")

style = ws.cells["A1"].get_style()

# Bold red font
style.font.bold = True
style.font.color = "FF0000"   # red
style.font.size = 13

# Yellow solid fill
style.set_fill_color("FFFF00")

# Thin black border on all four sides
for side in ("top", "bottom", "left", "right"):
    style.set_border(side, line_style="thin", color="000000", weight=1)

# Center the text
style.set_horizontal_alignment("center")

ws.cells["A1"].apply_style(style)

wb.save("styled.xlsx")

Voir aussi

• Cells Python API Reference accueil
• Référence de la classe Workbook
• Référence de la classe Worksheet
• Référence de la classe Cell
• Premiers pas