Style — Aspose.Cells FOSS for Python API Reference

Enumerations Style клас і його супутні типи керують усім візуальним та захисним форматуванням, застосованим до клітинок у aspose-cells-foss. A Style об’єкт отримується з клітинки за допомогою cell.get_style() і застосовується назад за допомогою cell.apply_style(style).

Enumerations: aspose.cells_foss

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

Enumerations

Enumerations

Style()

Створює типове Style без явного застосованого форматування.

Enumerations

Enumerations

копіювати

style.copy() -> Style

Повертає глибоку копію цього об’єкта стилю.

set_fill_color

style.set_fill_color(color: str)

Встановлює колір суцільного заповнення фону. color є рядком у форматі RRGGBB (наприклад,., "FFFF00" для жовтого).

set_fill_pattern

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

Встановлює шаблонне заповнення. pattern_type значення включають '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()

Очищає будь‑яке заповнення, роблячи фон клітинки прозорим (без заповнення).

set_border_color

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

Встановлює колір однієї сторони межі. side має бути одним із 'top', 'bottom', 'left', 'right', 'diagonal'. color є рядком у форматі RRGGBB.

set_border_style

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

Встановлює стиль лінії сторони межі. style значення: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.

set_border_weight

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

Встановлює товщину (ширину) лінії межі як ціле число.

set_border

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

Зручний метод, який встановлює стиль лінії, колір та товщину для однієї сторони межі одним викликом.

set_diagonal_border

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

Встановлює діагональну межу. Передайте up=True для діагоналі, що спрямована вгору, down=True для діагоналі вниз, або обох, щоб намалювати хрест.

set_horizontal_alignment

style.set_horizontal_alignment(alignment: str)

Встановлює горизонтальне вирівнювання тексту. Значення: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.

set_vertical_alignment

style.set_vertical_alignment(alignment: str)

Встановлює вертикальне вирівнювання тексту. Значення: 'top', 'center', 'bottom', 'justify', 'distributed'.

set_text_wrap

style.set_text_wrap(wrap=True)

Вмикає або вимикає перенесення тексту в межах комірки.

set_shrink_to_fit

style.set_shrink_to_fit(shrink=True)

Вмикає або вимикає стискання під розмір. Коли ввімкнено, текст зменшується, щоб вміститися у ширину комірки.

set_indent

style.set_indent(indent: int)

Встановлює рівень відступу (0–15).

set_text_rotation

style.set_text_rotation(rotation: int)

Встановлює обертання тексту в градусах. Допустимі значення: 0–180 (проти годинникової стрілки від 0°) або 255 (вертикальний текст, розташований зверху вниз).

set_reading_order

style.set_reading_order(order: int)

Встановлює порядок читання. 0 = залежить від контексту, 1 = зліва направо, 2 = справа наліво.

set_number_format

style.set_number_format(format_code: str)

Застосовує власний рядок формату числа (наприклад,., "DD/MM/YYYY", "#,##0.00 [$€-407]").

set_builtin_number_format

style.set_builtin_number_format(format_id: int)

Застосовує один із вбудованих числових форматів Excel за його цілим ідентифікатором (наприклад,., 9 = "0%", 14 = "m/d/yy").

set_locked

style.set_locked(locked=True)

Позначає клітинку як заблоковану. Заблоковані клітинки не можна редагувати, коли захист листа активний.

set_formula_hidden

style.set_formula_hidden(hidden=True)

Приховує формули у рядку формул, коли захист листа активний.

Enumerations

Enumerations

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

Enumerations

Enumerations

Enumerations

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

Enumerations

Enumerations

set_solid_fill

fill.set_solid_fill(color: str)

Застосовує суцільне заповнення заданим кольором у форматі RRGGBB.

set_gradient_fill

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

Застосовує градієнтне заповнення двох кольорів.

set_pattern_fill

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

Застосовує візерункове заповнення з явними кольорами переднього плану та фону.

set_no_fill

fill.set_no_fill()

Видаляє будь-яке заповнення з комірки.

Enumerations

Enumerations

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

Enumerations

Enumerations

Enumerations

Borders()

Контейнер для всіх чотирьох меж комірки та діагональних меж.

Enumerations

Enumerations

Enumerations

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

Enumerations

NumberFormat

NumberFormat є утилітним класом лише зі статичними методами. Він не створюється безпосередньо.

Статичні методи

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

Повертає рядок коду формату для заданого вбудованого ідентифікатора формату (наприклад,., NumberFormat.get_builtin_format(9) повертає "0%").

is_builtin_format

NumberFormat.is_builtin_format(format_code: str) -> bool

Enumerations True якщо заданий код формату відповідає відомому вбудованому формату Excel.

lookup_builtin_format

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

Повертає вбудований ідентифікатор формату для рядка коду формату, або None якщо код не є вбудованим форматом.

Enumerations

Enumerations

Protection(locked=True, hidden=False)

Enumerations

Enumerations

Наступний приклад оформляє заголовкову комірку жирним червоним текстом, жовтим фоном і тонкою чорною межею з усіх боків.

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")

Див. також

• Cells Python API Reference home
• Посилання на клас Workbook
• Довідка класу Worksheet
• Посилання на клас Cell
• Початок роботи