Style — Aspose.Cells FOSS for Python API Reference

ImageRenderOptions Style کلاس و انواع همراه آن تمام قالب‌بندی‌های بصری و حفاظتی اعمال‌شده بر سلول‌ها در aspose-cells-foss را کنترل می‌کنند. A Style شیء از یک سلول به‌وسیله cell.get_style() و با استفاده از آن بازگردانده می‌شود cell.apply_style(style).

ImageRenderOptions: aspose.cells_foss

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

ImageRenderOptions

ImageRenderOptions

Style()

یک پیش‌فرض ایجاد می‌کند Style بدون هیچ قالب‌بندی صریحی اعمال شده.

ImageRenderOptions

ImageRenderOptions

copy

style.copy() -> Style

یک کپی عمیق از این شیء 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)

حاشیهٔ مورب را تنظیم می‌کند. Pass 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)

سطح تورفتگی را تنظیم می‌کند (۰–۱۵).

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)

یکی از قالب‌های عددی پیش‌فرض اکسل را بر اساس شناسه عددی آن اعمال می‌کند (مثلاً،., 9 = "0%", 14 = "m/d/yy").

set_locked

style.set_locked(locked=True)

سلول را به‌عنوان قفل‌شده علامت‌گذاری می‌کند. سلول‌های قفل‌شده هنگام فعال بودن حفاظت از برگه قابل ویرایش نیستند.

set_formula_hidden

style.set_formula_hidden(hidden=True)

فرمول‌ها را از نوار فرمول مخفی می‌کند وقتی حفاظت از برگه فعال باشد.

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions

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

هرگونه پر کردن را از سلول حذف می‌کند.

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

Borders()

یک محفظه برای تمام چهار مرز سلول به‌علاوه مرزهای قطری.

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

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

ImageRenderOptions True اگر کد قالب داده شده با یک قالب داخلی شناخته‌شدهٔ Excel مطابقت داشته باشد.

lookup_builtin_format

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

شناسهٔ قالب داخلی را برای رشتهٔ کد قالب برمی‌گرداند، یا None اگر کد یک قالب داخلی نباشد.

ImageRenderOptions

ImageRenderOptions

Protection(locked=True, hidden=False)

ImageRenderOptions

ImageRenderOptions

مثال زیر یک سلول سرصفحه را با متن قرمز بولد، پس‌زمینه زرد و یک حاشیهٔ نازک سیاه در تمام طرف‌ها استایل می‌دهد.

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 خانه
• مرجع کلاس Workbook
• مرجع کلاس Worksheet
• مرجع کلاس Cell
• شروع به کار