Home » Python » python-docxの使い方 » python-docxでWordのセルを結合する－_Cell.merge()メソッド

python-docxでWordのセルを結合する－_Cell.merge()メソッド

動作検証バージョン：Windows 11 Home（64-bit）+ Python 3.10.6（64-bit）+ python-docx 0.8.11

Word等で作成されたdocxファイルを操作するPythonの外部ライブラリpyhon-docxを使う、Word文書内に存在する表のセル結合もご紹介しておきます。

［スポンサードリンク］

python-docxで表のセルを結合するサンプル

Cドライブtempフォルダーに、表の存在するsamp_org.docxを用意しておいてから、以下のスクリプトを実行してください。

import docx

doc = docx.Document(r'C:\temp\samp_org.docx')

tbl = doc.tables[0]

cel_a = tbl.cell(0, 0)
cel_z = tbl.cell(1, 1)
cel_a.merge(cel_z)

doc.save(r'c:\temp\samp_new.docx')

1行1列目のセルから2行2列目までの4つのセルが結合された、samp_new.docxファイルが、Cドライブtempフォルダーに作成されます。

セルの結合を行っているのは、

cel_a.merge(cel_z)

の行です。
python-docxでも、python-pptxと同様、_Cellオブジェクトのmerge()メソッドでセルを結合できます。

python-pptxの_Cell.mereg()メソッドと同様に、起点であるセルを表す_Cellオブジェクトのmerge()メソッドを使って、どのセルまで結合するかを引数で指定します。

上記のサンプルの場合、起点となる1行目×1列目のセルを変数cel_aに代入し、

cel_a = tbl.cell(0, 0)

終点となる2行目×2列目のセルを変数cel_zに代入しておいて、

cel_z = tbl.cell(1, 1)

_Cell.mereg()メソッドを呼んでいます。

cel_a.merge(cel_z)

最終更新日時：2023-04-17 11:11

［スポンサードリンク］

Home » Python » python-docxの使い方 » python-docxでWordのセルを結合する－_Cell.merge()メソッド

『インストラクターのネタ帳』では、2003年10月からMicrosoft Officeの使い方などを紹介し続けています。
Excel VBAの経験がある方を対象に、Word VBAの基本をキンドル本としてまとめました↓↓

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

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

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

日経BP社から出版された、Excel VBAユーザー向けのPython超入門書です↓↓

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

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

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

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

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

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

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

「python-docxの使い方」の記事一覧