Sparkline — Aspose.Cells FOSS for Python API Reference

اسپارکلاین‌ها نمودارهای مینیاتوری هستند که در سلول‌های جداگانه جاسازی می‌شوند و در Excel 2010 معرفی شدند. aspose-cells-foss اسپارکلاین‌ها را از طریق SparklineGroup و SparklineGroupCollection (ws.sparkline_groups). هر گروه یک یا چند Sparkline شیءها که تنظیمات نوع و رنگ یکسانی دارند.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import SparklineType, SparklineEmptyCells, Sparkline, SparklineGroup

SparklineType

SparklineType یک IntEnum که شکل بصری یک گروه اسپارکلاین را شناسایی می‌کند.

SparklineEmptyCells

SparklineEmptyCells یک IntEnum کنترل نحوه‌ی پردازش سلول‌های خالی درون یک نمودار کوچک.

ImageRenderOptions

یک Sparkline یک بازه داده‌ای را به یک مکان سلول واحد متصل می‌کند.

ImageRenderOptions

Sparkline(data_range: str, cell_reference: str)

ImageRenderOptions

SparklineGroup

A SparklineGroup تنظیمات بصری مشترک (نوع، رنگ‌ها، مدیریت سلول‌های خالی) را برای مجموعه‌ای از اسپارکلاین‌ها تعریف می‌کند. SparklineGroup اشیاء به‌صورت مستقیم ساخته نمی‌شوند — از ws.sparkline_groups.add(...) یا ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptions

add_sparkline

group.add_sparkline(data_range: str, cell_reference: str) -> Sparkline

یک اسپارکلاین فردی به این گروه اضافه می‌کند و جدید را برمی‌گرداند Sparkline شی.

SparklineGroupCollection

SparklineGroupCollection به عنوان دسترسی می‌شود ws.sparkline_groups. شامل تمام گروه‌های اسپارکلاین در یک برگه کاری است.

ImageRenderOptions

افزودن

ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range=None,
    is_vertical=False,
    location_range=None
) -> SparklineGroup

یک گروه جدید ایجاد می‌کند و به‌صورت اختیاری آن را با اسپارکلاین‌های استخراج‌شده از data_range (سطرها یا ستون‌ها بسته به is_vertical) که در سلول‌های توصیف‌شده توسط location_range. مقدار جدید را برمی‌گرداند SparklineGroup.

add_group

ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroup

یک گروه خالی از نوع داده‌شده ایجاد می‌کند. اسپارکلاین‌ها باید به‌صورت جداگانه با group.add_sparkline(...).

ویژگی‌ها و تکرار

ImageRenderOptions

مثال زیر داده‌های درآمد ماهانه برای سه منطقه را می‌نویسد و برای هر سطر یک اسپارکلاین خطی اضافه می‌کند.

from aspose.cells_foss import Workbook, SparklineType, SparklineEmptyCells

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Trends"

# Write headers
months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
for col, m in enumerate(months):
    ws.cells[0][col + 1].put_value(m)

ws.cells["A1"].put_value("Region")
ws.cells["H1"].put_value("Trend")

# Write three rows of data
regions = [
    ("North", [12000, 14500, 13800, 16200, 15900, 17400]),
    ("South", [9800,  10200, 11500, 10900, 12300, 13100]),
    ("West",  [7500,   8100,  7900,  8800,  9200, 10500]),
]
for row_i, (name, values) in enumerate(regions, start=1):
    ws.cells[row_i][0].put_value(name)
    for col_i, v in enumerate(values):
        ws.cells[row_i][col_i + 1].put_value(v)

# Add a line sparkline group — one sparkline per data row
group = ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range="Trends!B2:G4",
    is_vertical=False,
    location_range="Trends!H2:H4",
)

# Customize colors
group.color_series = "4472C4"       # blue lines
group.color_high   = "70AD47"       # green for peak
group.color_low    = "FF0000"       # red for trough
group.display_empty_cells_as = SparklineEmptyCells.GAP

wb.save("sparklines.xlsx")

همچنین ببینید

• Cells Python API Reference خانه
• مرجع کلاس Workbook
• مرجع کلاس Worksheet
• مرجع نمودار
• شروع به کار