Word 文書に画像を挿入すると、大量のテキストを分割し、内容を視覚的にわかりやすくすることができます。また、複雑な概念や説明しにくい内容を効果的に伝える手段にもなります。本記事では、Spire.Doc for Python を使用してプログラムで Word 文書に画像を追加する方法を紹介します。
Spire.Doc for Python のインストール
この操作には、Spire.Doc for Python と plum-dispatch v1.7.4 が必要です。これらは、Spire.Doc for Python の公式ウェブサイトから手動でダウンロードするか、以下の pip コマンドでインストールできます。
pip install Spire.DocPython で Word 文書に画像を挿入する
Spire.Doc for Python では、Paragraph.AppendPicture() メソッドを使用して Word 文書に画像を挿入できます。以下の手順で実装できます。
- Document オブジェクトを作成します。
- Document.AddSection() メソッドを使用してセクションを追加します。
- Section.AddParagraph() メソッドを使用して、セクションに 2 つの段落を追加します。
- 段落にテキストを追加し、書式を設定します。
- 画像を読み込み、Paragraph.AppendPicture() メソッドを使用して指定した段落に追加します。
- DocPicture.Width および DocPicture.Height プロパティを使用して、画像の幅と高さを設定します。
- DocPicture.TextWrappingStyle プロパティを使用して、画像のテキストの折り返しスタイルを設定します。
- Document.SaveToFile() メソッドを使用して、結果の文書を保存します。
- Python
from spire.doc import Document, TextWrappingStyle, FileFormat
# Documentオブジェクトを作成
document = Document()
# セクションを追加
section = document.AddSection()
section.PageSetup.Margins.All = 50
# 段落を追加
paragraph1 = section.AddParagraph()
# 段落にテキストを追加し、フォーマットを設定
tr = paragraph1.AppendText("Spire.Doc for Pythonは、開発者が高速かつ高品質なパフォーマンスでWord文書を作成、読み取り、書き込み、変換、および比較するために特別に設計されたプロフェッショナルなWord Python APIです。")
tr.CharacterFormat.FontName = "Yu Gothic UI"
tr.CharacterFormat.FontSize = 11
paragraph1.Format.LineSpacing = 18
paragraph1.Format.BeforeSpacing = 10
paragraph1.Format.AfterSpacing = 10
# 別の段落を追加
paragraph2 = section.AddParagraph()
tr = paragraph2.AppendText("Spire.Doc for Pythonは、多くのWord文書処理タスクを実行することを可能にします。Word 97-2003 / 2007 / 2010 / 2013 / 2016 / 2019をサポートしており、XML、RTF、TXT、XPS、EPUB、EMF、HTMLなどの一般的に使用されるファイル形式への変換やその逆も可能です。さらに、Pythonを使用してWord Doc/DocxをPDFに変換したり、WordをSVGやPostScriptに高品質で変換することをサポートしています。")
# 段落にテキストを追加し、フォーマットを設定
tr.CharacterFormat.FontName = "Yu Gothic UI"
tr.CharacterFormat.FontSize = 11
paragraph2.Format.LineSpacing = 18
# 指定した段落に画像を追加
picture = paragraph1.AppendPicture("Spire.Doc for Python.png")
# 画像の幅と高さを設定
picture.Width = 100
picture.Height = 100
# 画像のテキスト折り返しスタイルを設定
picture.TextWrappingStyle = TextWrappingStyle.Square
# 結果の文書を保存
document.SaveToFile("output/Wordに画像を挿入.docx", FileFormat.Docx)
document.Close()
Python で Word 文書の指定位置に画像を挿入する
画像を Word 文書の特定の位置に配置したい場合は、DocPicture.HorizontalPosition および DocPicture.VerticalPosition プロパティを設定することで調整できます。以下の手順で実装できます。
- Document オブジェクトを作成します。
- Document.AddSection() メソッドを使用してセクションを追加します。
- Section.AddParagraph() メソッドを使用して、セクションに段落を追加します。
- 段落にテキストを追加し、書式を設定します。
- Paragraph.AppendPicture() メソッドを使用して、段落に画像を追加します。
- DocPicture.Width および DocPicture.Height プロパティを使用して、画像の幅と高さを設定します。
- DocPicture.HorizontalPosition および DocPicture.VerticalPosition プロパティを使用して、画像の横位置と縦位置を設定します。
- DocPicture.TextWrappingStyle プロパティを使用して、画像のテキストの折り返しスタイルを設定します。
- Document.SaveToFile() メソッドを使用して、結果の文書を保存します。
- Python
from spire.doc import Document, FileFormat, TextWrappingStyle, Color
# Document オブジェクトを作成します。
doc = Document()
# セクションを追加します。
section = doc.AddSection()
section.PageSetup.Margins.All = 50
# セクションに段落を追加します。
paragraph = section.AddParagraph()
# 段落にテキストを追加し、書式を設定します。
textRange = paragraph.AppendText("このサンプルは、Word 文書の指定した位置に画像を挿入する方法を示します。")
textRange.CharacterFormat.FontName = "Yu Gothic UI"
textRange.CharacterFormat.FontSize = 14
textRange.CharacterFormat.TextColor = Color.get_BlueViolet()
# 段落に画像を追加します。
picture = paragraph.AppendPicture("Image.jpg")
# 画像の位置を設定します。
picture.HorizontalPosition = 150.0
picture.VerticalPosition = 80.0
# 画像のサイズを設定します。
picture.Width = 100.0
picture.Height = 160.0
# 画像の折り返しスタイルを設定します。
# （テキストの折り返しスタイルが「インライン」の場合、位置設定は適用されません。）
picture.TextWrappingStyle = TextWrappingStyle.Through
# 文書を保存します。
doc.SaveToFile("output/Wordに画像を挿入.docx", FileFormat.Docx)
doc.Close()
一時ライセンスを申請する
結果ドキュメントから評価メッセージを削除したい場合、または機能制限を取り除く場合は、についてこのメールアドレスはスパムボットから保護されています。閲覧するにはJavaScriptを有効にする必要があります。にお問い合わせ、30 日間有効な一時ライセンスを取得してください。
