如何使用 openpyxl 處理 Excel 註解?Comment 物件介紹
訂閱 480
閱讀本節的先決條件是已經了解 Excel 儲存格物件Cell,你可以檢視如何使用 openpyxl 處理 Excel 儲存格?Cell 物件介紹一節來取得相關資訊。
openpyxl Excel 註解物件 Comment
openpyxl套件中的Comment類別,屬於模組openpyxl.comments.comments,用於表示 Excel 中的註解。
什麽是 Excel 註解?
在 Excel 檔案中,註解一般用於儲存格,可以為使用者提供更多有用的資訊。
建立 Excel 註解
使用Comment物件的建構子,可以建立新的註解,這些註解可與 Excel 檔案中的儲存格關聯。
Comment(text, author, height=79, width=144)
- text 參數
text參數是註解的文字內容,可以是 Python 字串或其他型別的值。- author 參數
author參數是一個字串,表示註解的作者。- height 參數
height參數是數值型別,表示註解的高度,預設值為79。- width 參數
width參數是數值型別,表示註解的寬度,預設值為144。
Comment 物件的特性
Comment物件擁有屬性text,以及變數author,height,width,在未作出修改時,他們的值與傳遞給Comment建構子的引數的值相同。
此外,Comment物件還擁有變數content,其作用與屬性text相同。
Comment 物件的 author 變數所表示的作者可能無法在 Office 軟體中顯示
雖然可以通過Comment物件的建構子或author變數,來設定儲存格註解的作者,但在不同的 Office 軟體中,註解的作者可能不會正確顯示。
取得和設定 Excel 註解
Cell物件的comment屬性,可以取得或設定 Excel 儲存格中的註解。comment屬性的傳回值是一個Comment物件,如果儲存格未包含註解,則Cell物件的comment屬性傳回空值None。
cell.comment
cell.comment = text
- text 值
text是一個表示註解的Comment物件。要移除儲存格中的註解,text應該為空值None。
在 Excel 檔案Comment.xlsx的工作表Sheet中,儲存格A1和B1沒有註解,我們通過新增的Comment物件為儲存格A1新增註解。
# 開啟 Comment.xlsx 中的工作表 Sheet
import openpyxl
wb = openpyxl.load_workbook('Comment.xlsx')
ws = wb['Sheet']
from openpyxl.comments.comments import Comment
# 為儲存格 A1 設定註解
ws['A1'].comment = Comment('一個註解!', '好人', 300, 500)
# 取得儲存格 B1,C1 的註解
print(ws['B1'].comment)
print(ws['C1'].comment)
# 修改儲存格 C1 的註解
c = ws['C1'].comment
c.text = '我改了一下'
c.width = 500
c.height = 500
wb.save('Apple.xlsx')None
Comment: 一頭熊! by 未知作者原始碼
src/zh-hant/openpyxl/cells/comments·codebeatme/office-programming·GitHub