Home » Python » xlwingsの使い方 » xlwingsでセルを結合する－Range.merge()メソッド

xlwingsでセルを結合する－Range.merge()メソッド

動作検証バージョン：Windows 11 Home（64-bit）+ 64bit Excel（バージョン2302 ビルド16130.20218 キック実行）+ Python 3.10.6（64-bit） + xlwings 0.29.1

「セル結合 python xlwings」
「python セル結合 xlwings」
といった検索キーワードで時折アクセスがあります。

Pythonの外部ライブラリxlwingsを使って、セルを結合するにはどのようなコードを書けばいいのか調べていた方による検索でしょう。

xlwingsでセルを結合するサンプル

以下のスクリプトを実行すると、新規にExcelブックが作成され、アクティブシートのA1:C2セルが結合され1つのセルになります。

import xlwings as xw

bk = xw.Book()
sht = bk.sheets.active

sht.range('A1:C2').merge()

Excel VBAでRange.Mergeメソッドを使えばセルを結合できるのと同様、xlwingsでもRangeオブジェクトのmerge()メソッドでセルを結合できます。

Excel VBAのRange.Mergeメソッドに引数Acrossを指定できるのと同様、xlwingsのRange.merge()メソッドでも引数acrossにTrueを指定することで、横方向にセルを結合できます。

先ほどのスクリプトにつづいて、

sht.range('A4:C5').merge(across=True)

を実行すると、
　　A4:C4セル
　　A5:C5セル
が、それぞれ結合されます。

Excel VBAの場合、データの存在するセルを結合しようとすると、
「セルを結合すると、左上の値のみが保持され、他のセルの値は破棄されます。」
メッセージが表示されます。

それに対しxlwingsの場合は、セルにデータがあったとしてもメッセージは表示されません。

main.pyモジュールのRangeクラスで、以下のように定義されているためです。

def merge(self, across=False):
with self.sheet.book.app.properties(display_alerts=False):
self.impl.merge(across)

Excel VBAユーザーのためのPythonプログラミング入門

伊藤潔人 2023-09-21

最終更新日時：2023-10-13 12:17

［スポンサードリンク］

Home » Python » xlwingsの使い方 » xlwingsでセルを結合する－Range.merge()メソッド

『インストラクターのネタ帳』では、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の使い方」の記事一覧