Pythonを使ってWord文書に背景を簡単に追加

Word文書の背景は、文書を装飾するためにページに追加される色や画像です。 文書の視覚的な魅力を高め、より生き生きとした有益な文書にする役割を果たします。 トピックや内容に適した背景を選ぶことで、読者の注意を引き、読む楽しみを増やすことができます。 さらに、背景は異なるセクションやコンテンツを区別するのに役立ち、文書をより明確で読みやすくします。 文書の目的やテーマによっては、背景を選ぶことで特定のムードや雰囲気を伝えることもできます。 ビジネス文書や販促資料では、背景を加えることでブランドイメージを表現し、プロフェッショナリズムを高めることもできます。この記事では、[Spire.Doc for Python](https://www.e-iceblue.com/Introduce/doc-for-python.html)を使って**Word文書に背景色や背景画像を追加**する方法を説明します。

- **[Word文書に背景色を追加](#word文書に背景色を追加)**
- **[Word文書にグラデーションの背景を追加](#word文書にグラデーションの背景を追加)**
- **[Word文書に背景画像を追加](#word文書に背景画像を追加)**

このチュートリアルにはSpire.Doc for Pythonが必要です。[Spire.Doc for Pythonは公式ウェブサイト](https://www.e-iceblue.com/Download/Spire-Doc-Python.html)からダウンロードするか、pip経由でインストールすることができます：
```powershell
pip install Spire.Doc
```

## Word文書に背景色を追加
Word文書の背景色を設定するには、背景の種類を「Color」に変更し、背景として色を選択します。詳しい手順は以下の通りです。

- **Document** オブジェクトを作成します。
- **Document.LoadFromFile()** メソッドを使用してWord文書を読み込みます。
- **Document.Background** プロパティを使用してドキュメントの背景を取得します。
- **Background.Type** プロパティで背景の種類を **Color** に設定します。
- **Background.Color** プロパティを使用して、背景として色を設定します。
- **Document.SaveToFile()** メソッドを使用して、結果のドキュメントを保存します。

**Python**
```python
from spire.doc import *
from spire.doc.common import *

# Documentオブジェクトを作成し、Word文書を読み込む
document = Document()
document.LoadFromFile("例.docx")

# 文書の背景を取得する
background = document.Background

# 背景の種類をColorにする
background.Type = BackgroundType.Color

# 背景色を設定する
background.Color = Color.get_AliceBlue()

# 文書を保存する
document.SaveToFile("output/背景色の追加.docx", FileFormat.Docx2016)
document.Close()
```

**エクスポート文書**
![Word文書に背景色を追加](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/278784/22c16616-a37d-8f17-0a24-12be2e038d69.png)

## Word文書にグラデーションの背景を追加
グラデーション背景とは、2色以上の色の間を滑らかに移行する背景スタイルを指します。グラデーション背景を追加するには、背景タイプを「Gradient」に変更し、グラデーションカラーを指定し、グラデーションシェーディングバリアントとスタイルを設定する必要があります。詳しい手順は以下の通りです。

- **Document** オブジェクトを作成します。
- **Document.LoadFromFile()** メソッドでWord文書を読み込みます。
- **Document.Background** プロパティを使用してドキュメントの背景を取得します。
- **Background.Type** プロパティを使用して、背景タイプを **Gradient** に設定します。
- **Background.Gradient.Color1** プロパティと **Background.Gradient.Color2** プロパティを使用して、2つのグラデーションカラーを設定します。
- **Background.Gradient.ShadingVariant** プロパティと **Background.Gradient.ShadingStyle** プロパティを使用して、グラデーションのシェーディングバリアントとスタイルを設定します。
- **Document.SaveToFile()** メソッドを使用して、結果のドキュメントを保存します。

**Python**
```python
from spire.doc import *
from spire.doc.common import *

# ドキュメントオブジェクトを作成
document = Document()
# Word文書を読み込む
document.LoadFromFile("例.docx")

# ドキュメントの背景を取得
background = document.Background

# 背景タイプをグラデーションに設定
background.Type = BackgroundType.Gradient

# 2つのグラデーションカラーを設定
background.Gradient.Color1 = Color.get_White()
background.Gradient.Color2 = Color.get_LightBlue()

# グラデーションのシェーディングバリアントとスタイルを設定
background.Gradient.ShadingVariant = GradientShadingVariant.ShadingDown
background.Gradient.ShadingStyle = GradientShadingStyle.Horizontal

# 結果のドキュメントを保存
document.SaveToFile("output/グラデーション背景の追加.docx", FileFormat.Docx2016)
document.Close()
```

**エクスポート文書**
![Word文書にグラデーションの背景を追加](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/278784/01d59712-08d6-9646-5536-802e3acf6be8.png)

## Word文書に背景画像を追加
Word文書に背景画像を追加するには、背景の種類を「Picture」に変更し、背景として画像を設定する必要があります。詳しい手順は以下の通りです。

- **Document** オブジェクトを作成する。
- **Document.LoadFromFile()** メソッドでWord文書を読み込みます。
- **Document.Background** プロパティを使用して、ドキュメントの背景を取得します。
- **Background.Type** プロパティで背景の種類を **Picture** に設定します。
- **Background.SetPicture()** メソッドを使用して、背景として画像を設定します。
- **Document.SaveToFile()** メソッドを使用して、結果のドキュメントを保存します。

**Python**
```python
from spire.doc import *
from spire.doc.common import *

# ドキュメントオブジェクトを作成
document = Document()
# Word文書を読み込む
document.LoadFromFile("例.docx")

# ドキュメントの背景を取得
background = document.Background

# 背景タイプを画像に設定
background.Type = BackgroundType.Picture

# 背景の透明度を設定
background.Gradient

# 背景画像を設定
background.SetPicture("背景画像.jpg")

# 結果のドキュメントを保存
document.SaveToFile("output/背景画像の追加.docx", FileFormat.Docx2016)
document.Close()
```

**エクスポート文書**
![Word文書に背景画像を追加](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/278784/f1287b4e-2655-f363-19b0-87be7dd6f1ec.png)

> **Spire.Doc for Pythonを使ってWord文書に透かしを挿入する方法の紹介です。 このAPIは他にも多くのWord文書処理機能をサポートしており、[Spire.Doc for Pythonのチュートリアル](https://www.e-iceblue.com/Tutorials/Python/Spire.Doc-for-Python/Program-Guide/Spire.Doc-for-Python-Program-Guide-Content.html)で確認することができます。 また、[Spire.Docフォーラム](https://www.e-iceblue.com/forum/spire-doc-f6.html)で議論に参加することもできます。**