Home » Python » xlwingsの使い方 » xlwingsで図形の色を変更する

xlwingsで図形の色を変更する

動作検証バージョン：Windows 11 Home + Python 3.10.6（64-bit） + xlwings 0.30.9 + 64bit Excel（バージョン2309 ビルド16811.20004 クイック実行）

Excel自体を操作するPythonの外部ライブラリ「xlwings」にも、図形を操作するためのShapeクラスが用意されています。

ただし、書式（見た目）を操作するメソッドやプロパティは実装されていません。
そのため、図形の色を変更するなどの見た目を操作するためには、Shape.apiプロパティを経由して、Excel VBAのShapeオブジェクトを操作する必要があります。

xlwingsで図形の色を変更するサンプルスクリプト

四角形や楕円などの図形が1つ存在するワークシートがアクティブな状態で以下のスクリプトを実行すると、図形の色が緑色に変化します。

import xlwings as xw
from xlwings.utils import rgb_to_int

sht = xw.sheets.active
shp = sht.shapes[0]

shp.api.Fill.ForeColor.RGB = rgb_to_int((0, 255, 0))

Shape.apiプロパティ下の

shp.api.Fill.ForeColor.RGB

の部分は、拙著『理解するExcel VBA／図形操作の基本』の「3-2. FillFormatは塗りつぶし書式を表す」で解説しているのと同じオブジェクトモデルです。

RGB値を設定する右辺は、Excel VBAならばVBAのRGB関数を使いますが、上記のサンプルでは、xlwingsのrgb_to_int()関数を使用しています。

def RGB(red, green, blue):
return red + (green << 8) + (blue << 16)

現在のxlwingsには、RGB値を整数にする以下のようなrgb_to_int()関数が、utilsモジュールに定義されています。

def rgb_to_int(rgb):
return rgb[0] + (rgb[1] * 256) + (rgb[2] * 256 * 256)

先述のサンプルスクリプトでは、このrgb_to_int()関数を使うため、以下の形でインポートを行っています。

from xlwings.utils import rgb_to_int

理解するExcel VBA／図形操作の基本

伊藤潔人 2021-11-28

［スポンサードリンク］

Home » Python » xlwingsの使い方 » xlwingsで図形の色を変更する

『インストラクターのネタ帳』では、2003年10月からMicrosoft Officeの使い方などを紹介し続けています。
日経BP社から出版された、Excel VBAユーザー向けのPython超入門書です↓↓

上記の『Excel VBAユーザーのためのPythonプログラミング』の、元になったキンドル本です↓↓

『インストラクターのネタ帳』を運営する伊藤潔人が、初めて書かせていただいた書籍です↓↓

PowerPoint VBA本は、実はオブジェクトブラウザーの使い方を徹底的に解説した本です↓↓

数式を使った条件付き書式設定が苦手な方に向けたKindle本を書きました↓↓

小数とPythonのdecimalモジュールの基本をキンドル本としてまとめました↓↓

Pythonの文字列フォーマットの基本をキンドル本としてまとめました↓↓

Excel VBAの経験がある方を対象に、Word VBAの基本をキンドル本としてまとめました↓↓

Excel VBAユーザーの方を対象として、Wordの表をVBAで操作する基礎をまとめました↓↓

図形を操作するExcel VBAの基本を解説したキンドル本を出しました↓↓

グラフを操作するExcel VBAの基本を解説したキンドル本です↓↓

Pythonの外部ライブラリOpenPyXL（オープンパイエクセル）の入門書を、Excel VBAユーザーに向けに書きました↓↓

「xlwingsの使い方」の記事一覧