PythonとopenpyxlでExcelグラフを自動作成！ChartSpaceのプロパティ完全ガイド

pip install openpyxl

import openpyxl
from openpyxl.chart import BarChart, Reference

# 1. 新しいワークブックを作成
wb = openpyxl.Workbook()
ws = wb.active
ws.title = "売上レポート"

# 2. サンプルデータをシートに書き込む
rows = [
    ["月", "売上"],
    ["1月", 120],
    ["2月", 150],
    ["3月", 180],
    ["4月", 160],
    ["5月", 200],
    ["6月", 210],
]

for row in rows:
    ws.append(row)

# 3. グラフオブジェクトを作成 (縦棒グラフ)
chart = BarChart()
chart.type = "col"
chart.style = 10  # スタイルを選択 (任意)
chart.title = "月別売上" # デフォルトのタイトル
chart.y_axis.title = "売上（万円）"
chart.x_axis.title = "月"

# 4. グラフのデータ範囲とカテゴリ範囲を指定
# データはB1セルからB7セルまで (ヘッダーを含む)
data = Reference(ws, min_col=2, min_row=1, max_row=7, max_col=2)
# カテゴリ(軸ラベル)はA2セルからA7セルまで
cats = Reference(ws, min_col=1, min_row=2, max_row=7, max_col=1)

# 5. データをグラフに追加
chart.add_data(data, titles_from_data=True)
chart.set_categories(cats)
chart.shape = 4 # グラフのサイズを調整 (任意)

# 6. グラフをシートに追加
ws.add_chart(chart, "D2") # D2セルを左上としてグラフを配置

# 7. Excelファイルを保存
wb.save("chart_sample.xlsx")

print("グラフを含むExcelファイルを作成しました。")

# --- グラフタイトルの詳細設定 ---
from openpyxl.drawing.text import Font, CharacterProperties

# chart.title は単なる文字列のため、詳細設定は chartspace 経由で行う
cs = chart.chartspace
# タイトルオブジェクトへの参照
title_obj = cs.title

if title_obj:
    # テキストプロパティ (txPr) を取得
    tp = title_obj.tx.rich.p[0].r[0]
    # キャラクタープロパティ (rPr) でフォントを設定
    tp.rPr = CharacterProperties(
        latin=Font(typeface='游ゴシック'), # フォントの種類
        sz=1800,  # フォントサイズ (18pt = 1800)
        b=True,   # 太字 (Bold)
        solidFill="00008B" # 文字色 (濃い青)
    )

# --- 凡例の位置と書式設定 ---
if chart.legend:
    chart.legend.position = 'b' # 凡例をグラフの下に配置

# --- プロットエリアの書式設定 ---
from openpyxl.drawing.properties import GraphicalProperties
from openpyxl.drawing.line import LineProperties

# プロットエリアの書式設定 (spPr) を取得
pa_spPr = chart.plot_area.spPr or GraphicalProperties()

# 背景を薄いグレーで塗りつぶし
pa_spPr.solidFill = "F2F2F2" # 色コードで指定

# 枠線をなしに設定
pa_spPr.ln = LineProperties(noFill=True)

chart.plot_area.spPr = pa_spPr

# --- グラフ全体の書式とレイアウト ---

# グラフエリア全体の書式設定 (spPr) を取得
chart_spPr = chart.graphical_properties or GraphicalProperties()

# グラフエリア全体の枠線を設定 (細い灰色の線)
chart_spPr.ln = LineProperties(solidFill="D9D9D9", w=7500) # wは線の太さ

chart.graphical_properties = chart_spPr

# --- グラフの角を丸くする ---
chart.rounded_corners = True

# ---------------------------------------------------
# ここからがChartSpaceを使ったカスタマイズコード
# ---------------------------------------------------
from openpyxl.drawing.text import Font, CharacterProperties
from openpyxl.drawing.properties import GraphicalProperties
from openpyxl.drawing.line import LineProperties

# 1. グラフタイトルの詳細設定
cs = chart.chartspace
title_obj = cs.title
if title_obj:
    tp = title_obj.tx.rich.p[0].r[0]
    tp.rPr = CharacterProperties(
        latin=Font(typeface='游ゴシック'),
        sz=1800, # 18pt
        b=True,
        solidFill="00008B"
    )

# 2. 凡例を下に配置
if chart.legend:
    chart.legend.position = 'b'

# 3. プロットエリアの背景を薄いグレーに、枠線はなし
pa_spPr = chart.plot_area.spPr or GraphicalProperties()
pa_spPr.solidFill = "F2F2F2"
pa_spPr.ln = LineProperties(noFill=True)
chart.plot_area.spPr = pa_spPr

# 4. グラフ全体の枠線を設定
chart_spPr = chart.graphical_properties or GraphicalProperties()
chart_spPr.ln = LineProperties(solidFill="D9D9D9", w=7500)
chart.graphical_properties = chart_spPr

# 5. グラフの角を丸める
chart.rounded_corners = True

print("グラフのカスタマイズが完了しました。")
# ---------------------------------------------------
# カスタマイズコードはここまで
# ---------------------------------------------------