Cells
Sparkline

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 זיהוי הצורה החזותית של קבוצת sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0קו ספארקליין — מציג נתונים כקו מחובר.
COLUMN1ספארקליין של עמודה — מציג נתונים כעמודות אנכיות.
WIN_LOSS2גרף ניצחונות/הפסדים — כל ערך מוצג כבלוק חיובי או שלילי.

SparklineEmptyCells

SparklineEmptyCells הוא IntEnum בקרת האופן שבו תאים ריקים מטופלים בתוך sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0מתייחס לתאים ריקים כאפס.
GAP1משאיר רווח כאשר תאים ריקים (הקו נשבר).
CONNECTED2מחבר ערכים סמוכים שאינם ריקים, מדלג על הפער.

ImageRenderOptions

א Sparkline קושר טווח נתונים יחיד למיקום תא יחיד.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrטווח בסגנון A1 המכיל את נתוני המקור של הספארקליין (למשל,., "Sheet1!B2:G2").
cell_referencestrכתובת תא בסגנון A1 שבה מוצג הספארקליין (למשל,., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrטווח נתוני המקור.
cell_referencestrכתובת תא להצגה.

SparklineGroup

A SparklineGroup מגדיר את ההגדרות החזותיות המשותפות (סוג, צבעים, טיפול בתאים ריקים) עבור קבוצה של sparklines. SparklineGroup אובייקטים אינם נבנים ישירות — השתמשו ב ws.sparkline_groups.add(...) או ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeטופס Sparkline: LINE, COLUMN, או WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsכיצד לטפל בתאים ריקים בטווח הנתונים.
color_seriesstrצבע לקו/עמודות הראשיים של ה‑sparkline, בפורמט הקסדצימלי RRGGBB.
color_negativestrצבע לעמודות עם ערך שלילי (WIN_LOSS ו‑COLUMN), בפורמט הקסדצימלי RRGGBB.
color_axisstrצבע של קו ציר האפס, בפורמט הקסדצימלי RRGGBB.
color_markersstrצבע של סמני נקודות הנתונים ב‑sparklines קו, בפורמט הקסדצימלי RRGGBB.
color_firststrצבע הדגשה לנקודת הנתון הראשונה, בפורמט הקסדצימלי RRGGBB.
color_laststrצבע הדגשה לנקודת הנתון האחרונה, בפורמט הקסדצימלי RRGGBB.
color_highstrצבע הדגשה לנקודת הנתון הגבוהה ביותר, בפורמט הקסדצימלי RRGGBB.
color_lowstrצבע הדגשה לנקודת הנתון הנמוכה ביותר, בפורמט הקסדצימלי RRGGBB.
sparklineslist[Sparkline]רשימה לקריאה בלבד של sparklines בודדים בקבוצה זו.
countintמספר הספארקליינים בקבוצה זו (קריאה בלבד).

ImageRenderOptions

add_sparkline 

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

מוסיף sparkline בודד לקבוצה זו ומחזיר את החדש Sparkline אובייקט.

SparklineGroupCollection

SparklineGroupCollection נגיש כ ws.sparkline_groups. הוא מכיל את כל קבוצות הספארקליין בגיליון עבודה.

ImageRenderOptions

add 

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.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeהצורה החזותית של הספארקליינים.
data_range`strNone`
is_verticalboolImageRenderOptions True, כל עמודה ב data_range מספקת ספארקליין אחד; כאשר False, כל שורה עושה זאת.
location_range`strNone`

add_group 

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

יוצר קבוצה ריקה מהסוג הנתון. יש להוסיף ספארקליינים באופן פרטני באמצעות group.add_sparkline(...).

מאפיינים ואיטרציה

ImageRenderOptionsImageRenderOptions
countמספר קבוצות הספארקליין בגיליון זה (קריאה בלבד).
__len__()ImageRenderOptions count.
__iter__()עובר על כל SparklineGroup העצמים.
__getitem__(index)מחזיר את SparklineGroup בבסיס אפס index.

ImageRenderOptions

הדוגמה הבאה כותבת נתוני הכנסות חודשיים עבור שלוש אזורים ומוסיפה sparkline קו לכל שורה.

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

ראה גם

 עברית