Sparkline — Aspose.Cells FOSS for Python API Reference
スパークラインは、個々のセルに埋め込まれたミニチュアチャートで、Excel 2010で導入されました。aspose-cells-foss はスパークラインを通じて管理します SparklineGroup と SparklineGroupCollection (ws.sparkline_groups). 各グループは1つ以上の Sparkline 同じタイプとカラー設定を共有するオブジェクトです。.
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import SparklineType, SparklineEmptyCells, Sparkline, SparklineGroupSparklineType
SparklineType は IntEnum スパークライングループの視覚的形状を識別します。.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
LINE | 0 | ライン スパークライン — データを連続した線として描画します。. |
COLUMN | 1 | カラム スパークライン — データを垂直バーとして描画します。. |
WIN_LOSS | 2 | 勝敗 スパークライン — 各値が正または負のブロックとして表示されます。. |
SparklineEmptyCells
SparklineEmptyCells は IntEnum スパークライン内で空白セルがどのように処理されるかを制御します。.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ZERO | 0 | 空のセルをゼロとして扱います。. |
GAP | 1 | セルが空の場合に隙間を残します（線が途切れます）。. |
CONNECTED | 2 | 隙間を飛ばして、隣接する非空の値を接続します。. |
ImageRenderOptions
A Sparkline 単一のデータ範囲を単一のセル位置にバインドします。.
ImageRenderOptions
Sparkline(data_range: str, cell_reference: str)| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
data_range | str | スパークラインのソースデータを含む A1 形式の範囲（例：., "Sheet1!B2:G2"). |
cell_reference | str | スパークラインが表示される A1 形式のセルアドレス（例：., "H2"). |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
data_range | str | ソースデータ範囲。. |
cell_reference | str | 表示セルアドレス。. |
SparklineGroup
A SparklineGroup スパークラインのセットに対する共有ビジュアル設定（タイプ、色、空セルの処理）を定義します。. SparklineGroup オブジェクトは直接構築されません — 使用してください ws.sparkline_groups.add(...) または ws.sparkline_groups.add_group(...).
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
type | SparklineType | スパークライン形式: LINE, COLUMN,、または WIN_LOSS. |
display_empty_cells_as | SparklineEmptyCells | データ範囲の空白セルの処理方法。. |
color_series | str | メインのスパークラインの線/バーの色（RRGGBB 16 進数）。. |
color_negative | str | 負の値のバー（WIN_LOSS と COLUMN）の色、RRGGBB 16 進数。. |
color_axis | str | ゼロ軸ラインの色、RRGGBB 16 進数。. |
color_markers | str | ラインスパークライン上のデータポイントマーカーの色、RRGGBB 16 進数。. |
color_first | str | 最初のデータポイントのハイライト色、RRGGBB 16 進数。. |
color_last | str | 最後のデータポイントのハイライト色、RRGGBB 16 進数。. |
color_high | str | 最高データポイントのハイライト色（RRGGBB 16進表記）。. |
color_low | str | 最低データポイントのハイライト色（RRGGBB 16進表記）。. |
sparklines | list[Sparkline] | このグループ内の個々のスパークラインの読み取り専用リスト。. |
count | int | このグループ内のスパークライン数（読み取り専用）。. |
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.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
sparkline_type | SparklineType | スパークラインのビジュアル形式。. |
data_range | `str | None` |
is_vertical | bool | ImageRenderOptions True, 各列は data_range 1つのスパークラインに供給します; when False, 各行が行います。. |
location_range | `str | None` |
add_group
ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroup指定されたタイプの空のグループを作成します。スパークラインは個別に追加する必要があります。 group.add_sparkline(...).
プロパティとイテレーション
| ImageRenderOptions | ImageRenderOptions |
|---|---|
count | このワークシート上のスパークライングループ数（読み取り専用）。. |
__len__() | ImageRenderOptions count. |
__iter__() | すべてを反復処理します SparklineGroup オブジェクト。. |
__getitem__(index) | 返します SparklineGroup ゼロベースで index. |
ImageRenderOptions
以下の例は、3 つの地域の月次売上データを書き込み、各行にライン スパークラインを追加します。.
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")