如何使用 openpyxl 處理 Excel 註解?Comment 物件介紹
訂閱 375
閱讀本節的先決條件是已經了解 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