Excelのコメント機能は、ユーザーが補足情報や備考を追加するための便利な手段です。コメントはテキストや画像の形式で挿入でき、指定セルのデータに対する説明や補足情報を提供します。コメントが追加されたセルにマウスを合わせると、その内容を簡単に確認でき、Excelドキュメントの可読性と理解度が向上します。
この記事では、Spire.XLS for Python を使用して Python で Excelワークシートにコメントを追加する方法 をご紹介します。
Spire.XLS for Python のインストール
この操作には、Spire.XLS for Python と plum-dispatch v1.7.4 が必要です。これらは、Spire.XLS for Python の公式ウェブサイトから手動でダウンロードするか、以下の pip コマンドでインストールできます。
pip install Spire.XLSExcelファイルにテキストコメントを追加する方法
Spire.XLS for Python では、CellRange.AddComment メソッドを使って、Excelのセルにテキストコメントを追加できます。以下に詳しい手順を示します。
- Workbook クラスのオブジェクトを作成します。
- Workbook.LoadFromFile メソッドを使用して、Excelファイルを読み込みます。
- Workbook.Worksheets[] プロパティを使って、最初のワークシートを取得します。
- Worksheet.Range[] プロパティで、対象のセルを取得します。
- CellRange.AddComment メソッドを使って、コメントの著者と内容を設定し、セルに追加します。
- コメントのフォントを設定します。
- Workbook.SaveToFile メソッドで結果ファイルを保存します。
from spire.xls import Workbook, ExcelColors, ExcelVersion
inputFile = "Sample.xlsx"
outputFile = "output/テキストにコメントを追加.xlsx"
# Workbook クラスのオブジェクトを作成
workbook = Workbook()
# サンプルファイルをディスクから読み込む
workbook.LoadFromFile(inputFile)
# 最初のワークシートを取得
sheet = workbook.Worksheets.get_Item(0)
# 指定されたセルを取得
range = sheet.Range.get_Item("D9")
# コメントの作成者と内容を設定（日本語）
author = "佐藤"
text = "年度別売上合計です。"
# 取得したセルにコメントを追加
comment = range.AddComment()
comment.Width = 200
comment.Visible = True
comment.Text = author + ":\n" + text
# コメントのフォントを設定
font = workbook.CreateFont()
font.FontName = "Yu Gothic UI"
font.KnownColor = ExcelColors.Black
font.IsBold = True
comment.RichText.SetFont(0, len(author), font)
# 結果ファイルを保存
workbook.SaveToFile(outputFile, ExcelVersion.Version2016)
workbook.Dispose()
Excelファイルに画像付きコメントを追加する方法
Spire.XLS for Python では、CellRange.AddComment と ExcelCommentObject.Fill.CustomPicture メソッドを使って、指定したセルに画像付きコメントを追加することも可能です。以下がその手順です。
- Workbook クラスのオブジェクトを作成します。
- Workbook.Worksheets[] プロパティで最初のワークシートを取得します。
- Worksheet.Range[] プロパティで対象のセルを取得し、必要に応じてセルにテキストを設定します。
- CellRange.AddComment メソッドでセルにコメントを追加します。
- 画像を読み込み、ExcelCommentObject.Fill.CustomPicture メソッドでコメントに画像を挿入します。
- コメントの高さと幅を設定します。
- Workbook.SaveToFile メソッドでファイルを保存します。
from spire.xls import Workbook
inputImageFile = "Sample.png"
inputExcelFile = "Sample.xlsx"
outputFile = "output/画像コメントを追加.xlsx"
# Workbook クラスのオブジェクトを作成
workbook = Workbook()
workbook.LoadFromFile(inputExcelFile)
# 最初のワークシートを取得
sheet = workbook.Worksheets.get_Item(0)
# 指定したセルを取得し、テキストを設定
range = sheet.Range.get_Item("D1")
# セルにコメントを追加
comment = range.get_Item("D1").AddComment()
# 画像ファイルを読み込み、コメントに画像を挿入
comment.Fill.CustomPicture(inputImageFile)
# コメントの高さと幅を画像に合わせて設定
comment.Height = 144
comment.Width = 200
comment.Visible = True
# ファイルを保存
workbook.SaveToFile(outputFile)
workbook.Dispose()
一時ライセンスを申請する
結果ドキュメントから評価メッセージを削除したい場合、または機能制限を取り除く場合は、についてこのメールアドレスはスパムボットから保護されています。閲覧するにはJavaScriptを有効にする必要があります。にお問い合わせ、30 日間有効な一時ライセンスを取得してください。
